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

MVP Reconnect …… ovvero quando entri nella “famigghia” resti sempre nella “famigghia”!!!

Ma di che “famigghia” stiamo parlando!!!!

Fermi tutti, non si tratta di robe strane o sette segrete o affari malavitosi….stiamo parlando della grande famiglia dei Microsoft MVP.

Per chi non sapesse cosa sono i Microsoft MVP, vi consiglio di fare un giro sul sito ufficiale del programma (link), ma, volendolo spiegare in pochisime parole, si tratta di un riconoscimento che Microsoft da a persone che si distinguono per il loro impegno, aiutando gli altri ad ottenere il massimo grazie alle tecnologie Microsoft. Si tratta di persone, non dipendenti Microsoft, che mettono la loro passione, il loro tempo, la loro buona volontà per la divulgazione e la condivisione della conoscenza. Non necessariamente (come qualcuno erroneamente sostiene, evidentemente non conoscendo le basi del programma) si tratta di professionisti nel termine letterale del termine ma si tratta comunque di un gruppo di persone che sacrifica un pò del suo tempo (e, a volte, vi assicuro neanche pò!!!) per la sua passione.

Pe…

Nuova versione del Band SDK

E’ di ieri l’annuncio del rilascio della nuova versione dell’SDK per il Microsoft Band.
Si tratta della versione 1.3.10417 (la precedente e, prima della serie, era la 1.3.10219 preview).
Maggiori informazioni, download dell’SDK per le tre piattaforme Windows Phone, iOS e Android all’indirizzo http://developer.microsoftband.com/.
Allo stesso indirizzo potrete trovare anche la documentazione.
Nei mesi scorsi mi sono gia’ occupato della precedente versione e questi sono i post che ne parlano:
Microsoft Band SDK Preview - First LookMicrosoft Band SDK Preview - ”Hello Band”Microsoft Band SDK Preview - Accesso ai sensoriMicrosoft Band SDK Preview - TileMicrosoft Band SDK Preview - NotificheMicrosoft Band SDK Preview - Personalizzazione
Gli argomenti trattati e il codice proposto dovrebbe, ad una prima lettura delle nuove funzionalita’ inserite, essere ancora valido e funzionante ma nei prossimi giorni prendero’ in esame tutti gli argomenti dei precedenti post e vedremo cosa cambia e cosa e’ …

Template di progetto per sviluppare applicazioni WPF con Intel® RealSense™

E’ disponibile, nella gallery di Visual Studio, la prima versione del mio template di progetto per applicazioni WPF scritte in C# che permette di realizzare applicazioni con l’SDK di Intel® RealSense™.Il template si può scaricare direttamente all’interno Visual Studio utilizzando il tool “Extensions and Updates”oppure all’indirizzo https://visualstudiogallery.msdn.microsoft.com/1c36ecfd-8c00-4aee-b20c-a1726ab6424dIl template esegue le seguenti operazioni per voi:Aggiunge la reference all’assembly libpxcclr.cs.dll (nelle due distinte versioni per x86 e x64);Aggiunge lo script di post build per copiare la libreria libpxccpp2c.dll dalla cartella dell’SDK alla cartella bin del vostro progetto.Una volta creato il progetto dovete rimuovere la configurazione di compilazione AnyCPU (che non ha più senso) dalla vostra solution e sarete pronti per sviluppare con Intel® RealSense™.Ovviamente dovete installare l’SDK che potete scaricare all’indirizzo https://software.intel.com/en-us/intel-realsen…