Passa ai contenuti principali

TFS2010 Object Model: TeamProjectPicker

L’object model di TFS 2010 mette a disposizione una finestra per permettere ai nostri utenti di selezionare un server TFS, una project collection o un progetto.

La finestra è implementata dalla classe TeamProjectPicker che si trova nel namespace Microsoft.TeamFoundation.Client (assembly Microsoft.TeamFoundation.Client.dll).

TeamProjectPicker permette una certa versatilità perché può servire per selezionare una project collection, un progetto o una serie di progetti.

Prima di vedere come si può ottenere ciò, vediamo come è strutturata la classe.

La classe ha tre costruttori che permettono di gestire la possibilità di scegliere cosa è possibile selezionare e quale provider di credenziali utilizzare.

In particolare, il costruttore più completo è il seguente:

  1. Public Sub New(ByVal mode As TeamProjectPickerMode,
  2.                 ByVal disableCollectionChange As Boolean,
  3.                 ByVal credentialsProvider As ICredentialsProvider)

L’argomento mode, di tipo TeamProjectPickerMode, permette di selezionare la modalità di selezione e può assumere i seguenti valori:

  • NoProject : è possibile selezionare server e project collection;
  • SingleProject : è possibile selezionare un solo progetto
  • MultiProject : si possono selezionare più progetti.

La seguente figura mostra come si presentano le differenti opzioni:

SNAGHTML11981afb

L’argomento disableCollectionChange permette di decidere se deve essere selezionata automaticamente la collezione di default (false) senza che possa essere modificata dall’utente oppure no (true).

Infine, l’argomento credentialsProvider permette di impostare il provider di credenziali da utilizzare nel caso in cui la connessione a TFS non disponga di credenziali valide. Il provider da noi impostato verrà richiamato nel momento in cui , a causa della mancanza di credenziali, l’utente clicca sul link “Use different credentials”.

La GUI, una volta istanziata, può essere personalizzata (a dire il vero non molto) utilizzando le seguenti proprietà:

  • AcceptButtonText: permette di impostare il testo che appare sul bottone di selezione;
  • HelpTopic: permette di impostare l’argomento della guida relativo al dialog;
  • Text: permette di impostare la caption del controllo.

e può essere mostrata all’utente con il metodo ShowDialog (come un usuale dialog windows forms).

La classe espone, infine, le due proprietà per recuperare la collection selezionata dall’utente (proprietà SelectedTeamProjectCollection di tipo TfsTeamProjectCollection) e i progetti (SelectedProjects di tipo ProjectInfo).

Il seguente pezzo di codice visualizza la dialog di selezione in modalità multi project e recupera i valori selezionati dall’utente:

  1. Dim pp = New TeamProjectPicker(TeamProjectPickerMode.MultiProject,
  2.                                False,
  3.                                New UICredentialsProvider())
  4. If pp.ShowDialog() = Windows.Forms.DialogResult.OK Then
  5.     Dim collection = pp.SelectedTeamProjectCollection
  6.     Dim projects = pp.SelectedProjects
  7.     '
  8.     '   Utilizzo di collection e projects
  9.     '
  10. End If

Prima di concludere il post vorrei segnalare il metodo SetDefaultSelectionProvider il cui scopo è quello di permettere di modificare la logica con cui il TeamProjectPicker recupera il server, la collezione e i progetti di default.

L’oggetto previsto come argomento del metodo è una qualsiasi classe che implementa l’interfaccia ITeamProjectPickerDefaultSelectionProvider. L’interfaccia prevede i seguenti metodi:

  • GetDefaultCollectionId : restituisce il GUID della collection di default del server il cui Uri è passto per argomento;
  • GetDefaultProjects : restituisce l’elenco degli Uri dei progetti relativi alla collection il cui Guid è passato per argomento;
  • GetDefaultServerUri : Restituisce l’Uri del server di default.

Questo ci permette di personalizzare la logica con cui il picker seleziona e propone i progetti all’utente.

Per concludere, il picker è un oggetto Windows Form, quindi è necessario referenziare l’assembly System.Windows.Forms.

 

Commenti

Post popolari in questo blog

VB.NET: Convertire un file DOC in RTF e PDF con office interop

In questo post vorrei proporvi del codice per poter convertire un file .doc in un file .rtf oppure .pdf utilizzando le API di interoperabilità di Office.Creeremo una classe, DocConverter, che esporrà le due funzionalità sopra citate.Cominciamo con il prevedere un attributo privato della classe che rappresenterà l’applicazione Word che utilizzeremo per la conversione. Creeremo l’istanza dell’attributo privato all’interno del costruttore della classe:PublicSubNew()
IfNot CreateWordApp() Then
ThrowNew ApplicationException("Assembly di interoperabilità con Office non trovato!")
EndIf
EndSub
Private _wordApp As Word.ApplicationClass
ProtectedFunction CreateWordApp() AsBoolean
Dim retval = True
Try
_wordApp = New Word.ApplicationClass()
_wordApp.Visible = False
Catch ex As System.Exception
_wordApp = Nothing
retval = False
EndTry
Return retval
EndFunction

La conversione del file doc sarà effettuata aprendo il file stesso ed eseguendo un’operazione di SaveAs:

Pr…

Tascam DR-05 registratore digitale per tutti

Diverso tempo fa ho acquistato il registratore digitale Tascam DR-05 e, ora, dopo diversi mesi di utilizzo, posso dire la mia a proposito.

Si tratta di un ottimo registratore digitale con microfono stereo che permette di ottenere registrazioni di ottima qualitaà anche in ambienti non perfetti dal punto di vista acustico.

Interessante la possibilità di utilizzare un cavalletto di piccole dimensioni come HAMA Mini treppiede o Mini Cavalletto Universale per tenere il microfono sollevato dal tavolo in fase di registrazione grazie allàattacco universale per macchina fotografica che il microfono ha nella parte inferiore.

Da segnalare anche il menu’ ben fatto e la possibilita’ di utilizzare una scheda SD esterna per memorizzare i file audio. Anche a livello di consumo batterie non e’ niente male. Consiglio l’uso delle alcaline non ricaricabili.

Il mio utilizzo e’ stato prettamente di registrazione di podcast vocali (no musica) ma le recensioni confermano che se la cava egregiamente con la mu…

Cambiare la lingua di Visual Studio 2008

Oggi ho avuto qualche problema installando Windows Mobile 6 Professional SDK Refresh e Windows Mobile 6 Standard SDK Refresh.Scaricati i file di installazione e installati, ho provato a creare un progetto di tipo Windows Mobile 6.0 e mi sono beccato questo errore:Dopo qualche smanettamento abbiamo scoperto (e ringrazio il mitico Matteo per l’aiuto) che il mio Visual Studio 2008, pur essendo in Inglese (prova ne era il fatto che gli hotfix e la SP installata erano nella lingua di Albione) aveva come lingua impostata quella del sistema operativo (italiano).Ovviamente, non avrebbe mai potuto trovare la cartella 1040 (italiano) visto che l’installazione dell’SDK aveva supposto che la lingua del Visual Studio fosse Inglese (1033).La soluzione del problema è duplice:1) Duplicate la cartella 1033 presente nel percorso evidenziato dall’errore e la rinominate 10402) cambiate la lingua di Visual Studio.Per questa ultima eventualità basta andare nel menù Strumenti/Opzioni:e cambiare il linguaggi…