Condividi tramite


Passaggio 1: Usare lo sviluppo guidato WCF LOB Adapter per creare il progetto Echo Adapter

Passaggio 1 di 9

Tempo da completare: 15 minuti

In questo passaggio si creerà un progetto usando Visual Studio e la Creazione guidata adapter. La Creazione guidata sviluppo adapter illustra i passaggi coinvolti nello sviluppo di una scheda personalizzata per il sistema. Raccoglie informazioni sui modelli di scambio dei messaggi, sulle funzionalità dei metadati, sulle proprietà della scheda e sulle proprietà di connessione. Al termine della procedura guidata, genera un set di file.

Prerequisiti

È necessario disporre delle conoscenze descritte in Prima di iniziare l'esercitazione e configurare correttamente il computer per lo sviluppo della scheda usando WCF LOB Adapter SDK.

Scegliere Plug-in Plug-in adapter WCF LOB in Visual Studio

  1. Avviare Visual Studio e quindi scegliere Nuovo dal menu File e quindi fare clic su Progetto.

  2. Nella finestra di dialogo New Project (Nuovo progetto) seguire questa procedura:

    Usare Per
    Tipi di progetto Fare clic su Visual C#.
    Modelli Fare clic su Adapter LOB WCF.
    Nome Digitare EchoAdapter.
    Posizione Digitare C:\Tutorials.
    Creare directory per la soluzione Selezionare questa casella di controllo per creare una directory per i file della soluzione.
    Nome soluzione Digitare EchoAdapterSampleV2.

    La figura seguente mostra la finestra di dialogo Nuovo progetto .

    Screenshot che mostra la finestra di dialogo Nuovo progetto.

  3. Fare clic su OK.

  4. Nella pagina Benvenuti fare clic su Avanti. La figura seguente mostra la pagina iniziale .

    Screenshot che mostra la pagina iniziale.

  5. Fare clic su Avanti.

Immettere lo schema e le informazioni sullo spazio dei nomi

  1. Nella pagina Schema, Spazio dei nomi e Informazioni URI eseguire le operazioni seguenti:

    Usare Per
    Schema Tipo echov2.
    Spazio dei nomi del progetto Digitare Microsoft.Adapters.Samples.EchoV2.

    Nella figura seguente viene illustrata la pagina Schema, Spazio dei nomi e informazioni URI .

    Screenshot che mostra la pagina Informazioni sullo schema, lo spazio dei nomi e l'URI.

  2. Fare clic su Avanti.

Immettere il flusso di dati e le funzionalità dei metadati

  1. Nella pagina Flussi di dati e funzionalità dei metadati eseguire le operazioni seguenti:

    Modelli di Scambio messaggi

    Usare Per
    Uscita sincrona Selezionare la casella di controllo.
    In ingresso sincrono Selezionare la casella di controllo.

    Funzionalità dei metadati

    Usare Per
    Recupero Selezionare la casella di controllo.
    Sfoglia Selezionare la casella di controllo.
    Ricerca Selezionare la casella di controllo.

    Nota

    I flussi di dati in questo contesto significano lo stesso dei modelli di scambio dei messaggi, il termine usato negli argomenti concettuali.

    Nella figura seguente viene illustrata la pagina Flussi di dati e funzionalità dei metadati .

    Screenshot che mostra la pagina Flussi di dati e funzionalità dei metadati.

  2. Fare clic su Avanti.

Immettere le proprietà dell'adapter

  1. Nella pagina Proprietà adapter eseguire le operazioni seguenti:

  2. Aggiungere una proprietà denominata Count. Questo numero viene usato da ogni operazione dell'adattatore echo. Ogni operazione restituirà il valore di input numero di volte.

    Usare Per
    Nome proprietà Numero di tipi.
    Tipo di dati Selezionare System.Int32.
    Valore predefinito Tipo 5.
    Aggiungere Fare clic per aggiungere la nuova proprietà adapter.
  3. Aggiungere una proprietà denominata EnableConnectionPooling. Questo flag viene usato dall'SDK dell'adapter LOB WCF per abilitare o disabilitare il pool di connessioni di runtime.

    Usare Per
    Nome proprietà Digitare EnableConnectionPooling.
    Tipo di dati Selezionare System.Boolean.
    Valore predefinito Digitare true.
    Aggiungere Fare clic per aggiungere la nuova proprietà adapter.
  4. Aggiungere una proprietà denominata InboundFileFilter. Questa proprietà viene usata da FileSystemWatcher per monitorare i file di questa estensione. Questa proprietà è applicabile solo per lo scenario in ingresso.

    Usare Per
    Nome proprietà Digitare InboundFileFilter.
    Tipo di dati Selezionare System.String.
    Valore predefinito Digitare *.txt.
    Aggiungere Fare clic per aggiungere la nuova proprietà adapter.
  5. Aggiungere una proprietà denominata InboundFileSystemWatcherFolder. Questa proprietà viene usata per impostare la cartella in cui i file verranno eliminati per FileSystemWatcher per generare la notifica all'adattatore. Questa proprietà è applicabile solo per lo scenario in ingresso.

    Usare Per
    Nome proprietà Digitare InboundFileSystemWatcherFolder.
    Tipo di dati Selezionare System.String.
    Valore predefinito Digitare C:\\in ingresso\\watcher.
    Aggiungere Fare clic per aggiungere la nuova proprietà adapter.

    La figura seguente mostra la pagina Proprietà adapter .

    Screenshot che mostra la pagina Proprietà adapter.

  6. Fare clic su Avanti.

Immettere le proprietà di connessione

  1. Nella pagina Proprietà connessione eseguire le operazioni seguenti:

  2. Aggiungere una proprietà denominata Application. Questa proprietà è solo per scopi illustrativi. L'adattatore echo non comporta alcun sistema LOB.

    Usare Per
    Nome proprietà Digitare Applicazione.
    Tipo di dati Selezionare System.String.
    Valore predefinito Tipo lobapplication.
    Aggiungere Fare clic per aggiungere la nuova proprietà adapter.
  3. Aggiungere una proprietà denominata EnableAuthentication. Quando true, l'adapter prevede un valore nel campo nome utente all'interno delle credenziali client.

    Usare Per
    Nome proprietà Digitare EnableAuthentication.
    Tipo di dati Selezionare System.Boolean.
    Valore predefinito Digitare false.
    Aggiungere Fare clic per aggiungere la nuova proprietà adapter.
  4. Aggiungere una proprietà denominata HostName. Questa proprietà è solo per scopi illustrativi, simile alla proprietà Application.

    Usare Per
    Nome proprietà Digitare Nome host.
    Tipo di dati Selezionare System.String.
    Valore predefinito Digitare lobhostname.
    Aggiungere Fare clic per aggiungere la nuova proprietà adapter.
  5. Aggiungere una proprietà denominata EchoInUpperCase. Questa proprietà controlla se alcune operazioni convertono stringhe echo in maiuscole o lasciano in formato originale.

    Usare Per
    Nome proprietà Digitare EchoInUpperCase.
    Tipo di dati Selezionare System.Boolean.
    Valore predefinito Digitare False.
    Aggiungere Fare clic per aggiungere la nuova proprietà adapter.
  6. Fare clic su Avanti.

Terminare la procedura guidata

  1. Nella pagina Summary fare clic su Finish. La figura seguente mostra Esplora soluzioni con il progetto EchoAdapter.

    Screenshot che mostra la Esplora soluzioni con il progetto EchoAdapter.

    Il progetto deve contenere gli stessi file. In caso contrario, uscire da Visual Studio, eliminare la cartella EchoAdapterSampleV2 e quindi riavviare questo passaggio dell'esercitazione.

  2. In Visual Studio fare clic su Salva tutto dal menu File.

    Nota

    Il lavoro è stato salvato. È possibile chiudere Visual Studio in questo momento o passare al passaggio successivo, passaggio 2: Categorizzare l'adapter e le proprietà di connessione.

Cosa ho fatto?

In questo passaggio è stata creata la soluzione dell'adapter echo usando Visual Studio e la Creazione guidata adapter. La tabella seguente contiene il set di file e il valore di ogni file.

Nome file Descrizione
EchoAdapter.cs Si tratta della classe dell'adattatore principale che eredita da Microsoft.ServiceModel.Channels.Common.Adapter.

Non sono necessarie modifiche per l'adattatore echo.
EchoAdapterBinding.cs Questa è la classe usata durante la creazione di un'associazione per un adattatore.

Non sono necessarie modifiche per l'adattatore echo.
EchoAdapterBindingCollectionElement.cs Si tratta della classe Elemento Binding Collection che implementa .System.ServiceModel.Configuration.StandardBindingCollectionElement

Non sono necessarie modifiche per l'adattatore echo.
EchoAdapterBindingElement.cs In questo modo viene fornita una classe di base per gli elementi di configurazione.

Per classificare le proprietà di adattatore e connessione dell'adattatore echo, seguire il passaggio 2: Categorizzare l'adapter e le proprietà di connessione.
EchoAdapterBindingElementExtensionElement.cs Questa classe viene fornita per rappresentare l'adapter come elemento di associazione, in modo che possa essere usata all'interno di un'associazione personalizzata WCF definita dall'utente.

Per classificare le proprietà di adattatore e connessione dell'adattatore echo, seguire il passaggio 2: Categorizzare l'adapter e le proprietà di connessione.
EchoAdapterHandlerBase.cs Questa è la classe di base per i gestori usati per archiviare le proprietà comuni/le funzioni helper esposte dalla classe di base.

Per classificare le proprietà di adattatore e connessione dell'adattatore echo, seguire il passaggio 2: Categorizzare l'adapter e le proprietà di connessione.
EchoAdapterConnection.cs In questo modo viene definita la connessione al sistema di destinazione.

Per supportare la connessione dell'adattatore echo al sistema di destinazione, seguire il passaggio 3: Implementare la connessione per l'adapter Echo.
EchoAdapterConnectionFactory.cs In questo modo viene definita la factory di connessione per il sistema di destinazione.

Per supportare la connessione dell'adattatore echo al sistema di destinazione, seguire il passaggio 3: Implementare la connessione per l'adapter Echo.
EchoAdapterConnectionUri.cs Questa è la classe per rappresentare un URI di connessione dell'adattatore.

Per supportare la connessione dell'adattatore echo al sistema di destinazione, seguire il passaggio 3: Implementare la connessione per l'adattatore Echo.
EchoAdapterMetadataBrowseHandler.cs Questa classe viene usata durante l'esecuzione di un'esplorazione basata su connessione per i metadati dal sistema di destinazione.

Per supportare la funzionalità di esplorazione dei metadati per l'adattatore echo, seguire il passaggio 4: Implementare il gestore di esplorazione dei metadati per l'adapter Echo.
EchoAdapterMetadataSearchHandler.cs Questa classe viene usata per eseguire una ricerca basata su connessione per i metadati dal sistema di destinazione.

Per supportare la funzionalità di ricerca dei metadati per l'adattatore echo, seguire il passaggio 5: Implementare il gestore di ricerca metadati per l'adapter Echo.
EchoAdapterMetadataResolve.cs Questa classe viene usata per eseguire un recupero basato sulla connessione dei metadati dal sistema di destinazione.

Per supportare la funzionalità di risoluzione dei metadati per l'adattatore echo, seguire il passaggio 6: Implementare il gestore di risoluzione dei metadati per l'adapter Echo.
EchoAdapterOutboundHandler.cs Questa classe viene usata per l'invio di dati al sistema di destinazione.

Per supportare lo scambio di messaggi in uscita per l'adapter echo, seguire il passaggio 7: Implementare il gestore in uscita sincrono per l'adapter Echo.
EchoAdapterInboundHandler.cs Questa classe implementa un'interfaccia per l'ascolto o il polling dei dati.

Per supportare lo scambio di messaggi in ingresso per l'adapter echo, seguire il passaggio 8: Implementare il gestore in ingresso sincrono per l'adapter Echo.
EchoAdapterTrace.cs Questa classe implementa la traccia degli adattatori per il debug e la risoluzione dei problemi.

Passaggi successivi

Categorizzare le proprietà di adattatore e connessione per il raggruppamento logico dell'interfaccia utente e quindi implementare la connessione, l'esplorazione dei metadati, la ricerca e la risoluzione delle funzionalità e gli scambi di messaggi in uscita e in ingresso. Infine, si compila e si distribuisce l'adattatore echo.

Vedere anche

Passaggio 2: Classificare l'adapter e le proprietà di connessione
Esercitazione 1: Sviluppare Echo Adapter