Condividi tramite


Creare un ricevitore di eventi

Creando ricevitori di eventi, è possibile rispondere quando un utente interagisce con elementi di SharePoint, ad esempio elenchi o voci di elenco. Ad esempio, il codice in un ricevitore di eventi può essere attivato quando un utente modifica il calendario o elimina un nome da un elenco contatti. Seguendo questo argomento, si apprenderà come aggiungere un ricevitore di eventi a un'istanza di elenco.

Per completare questi passaggi, è necessario aver installato Visual Studio e le edizioni supportate di Windows e SharePoint. Poiché questo esempio richiede un progetto di SharePoint, è necessario aver completato anche la procedura descritta nell'argomento Procedura dettagliata: Creare una colonna del sito, un tipo di contenuto ed un elenco per SharePoint.

Aggiunta di un ricevitore di eventi

Il progetto creato in Procedura dettagliata: Creare una colonna del sito, un tipo di contenuto e un elenco per SharePoint include colonne di sito personalizzate, un elenco personalizzato e un tipo di contenuto. Nella procedura seguente si espanderà questo progetto aggiungendo un gestore eventi semplice (un ricevitore di eventi) a un'istanza di elenco per mostrare come gestire gli eventi che si verificano in elementi di SharePoint, ad esempio elenchi.

Per aggiungere un ricevitore di eventi all'istanza dell'elenco

  1. Aprire il progetto creato in Procedura dettagliata: Creare una colonna del sito, un tipo di contenuto ed un elenco per SharePoint.

  2. In Esplora soluzioni scegliere il nodo del progetto SharePoint, denominato Clinic.

  3. Nella barra dei menu scegliere Progetto>Aggiungi nuovo elemento.

  4. In Visual C# o Visual Basic espandere il nodo SharePoint e quindi scegliere l'elemento 2010.

  5. Nel riquadro Modelli scegliere Ricevitore eventi, denominarlo TestEventReceiver1 e quindi scegliere il pulsante OK.

    Verrà visualizzata la Personalizzazione guidata SharePoint.

  6. Nell'elenco Tipo di ricevitore di eventi desiderato scegliere Eventi voce elenco.

  7. Nell'elenco Quale elemento deve essere l'origine evento sceglierePazienti (Clinica\Pazienti).

  8. Nell'elenco Gestisci gli eventi seguenti selezionare la casella di controllo accanto a Un elemento aggiunto e quindi scegliere il pulsante Fine .

    Il file di codice per il nuovo ricevitore di eventi contiene un singolo metodo denominato ItemAdded. Nel passaggio successivo si aggiungerà il codice a questo metodo in modo che ogni contatto sia denominato Scott Brown per impostazione predefinita.

  9. Sostituire il metodo esistente ItemAdded con il codice seguente e quindi scegliere il tasto F5 :

    public override void ItemAdded(SPItemEventProperties properties)
    {
        properties.ListItem["Patient Name"] = "Scott Brown";
        properties.ListItem.Update();
        base.ItemAdded(properties);
    }
    

    Il codice viene eseguito e il sito di SharePoint viene visualizzato nel Web browser.

  10. Sulla barra di avvio rapido scegliere il collegamento Pazienti e quindi scegliere il collegamento Aggiungi nuovo elemento .

    Verrà aperto il modulo di immissione per i nuovi elementi.

  11. Immettere i dati nei campi e quindi scegliere il pulsante Salva .

    Dopo aver scelto il pulsante Salva , la colonna Nome paziente viene aggiornata automaticamente al nome Scott Brown.