Condividi tramite

Procedura: creare un ricevitore di eventi

  • Articolo

I ricevitori di eventi sono classi che consentono di rispondere agli eventi che concernono gli elementi di SharePoint, ad esempio elenchi o voci di elenco. Quando un utente modifica il calendario o elimina un nome dall'elenco dei contatti, viene attivato il codice del ricevitore di eventi.

In questa procedura vengono illustrate le attività seguenti:

  • Aggiunta di un ricevitore di eventi a un'istanza di elenco.

Per eseguire questi passaggi è necessario disporre dei seguenti componenti:

È necessario completare anche la procedura nell'argomento Procedura dettagliata: creare un campo personalizzato, un tipo di contenuto, una definizione di elenco e un'istanza di elenco.

Aggiunta di un ricevitore di eventi

Nel progetto creato in Procedura dettagliata: creare un campo personalizzato, un tipo di contenuto, una definizione di elenco e un'istanza di elenco sono inclusi un campo personalizzato, una definizione di elenco personalizzata con un'istanza di tale elenco e un tipo di contenuto. Successivamente si aggiungerà un ricevitore di eventi a tale progetto. La procedura riportata di seguito consente di aggiungere un semplice gestore eventi (un ricevitore di eventi) all'istanza di elenco.

Per aggiungere un ricevitore di eventi all'istanza di elenco

  1. Aprire il progetto creato in Procedura dettagliata: creare un campo personalizzato, un tipo di contenuto, una definizione di elenco e un'istanza di elenco.

  2. Aggiungere un ricevitore di eventi a questo progetto. A tal fine, fare clic sul nodo del progetto in Esplora soluzioni, quindi scegliere Aggiungi nuovo elemento dal menu Progetto.

  3. Espandere il nodo SharePoint sotto Visual C# o Visual Basic, quindi fare clic su 2010.

  4. Nel riquadro Modelli selezionare Ricevitore di eventi e assegnare a esso il nome TestEventReceiver1.

    Viene visualizzata la Personalizzazione guidata SharePoint.

  5. Nella pagina Selezionare i ricevitori di eventi scegliere Eventi elementi elenco come tipo di ricevitore di eventi.

  6. Impostare Elemento di origine evento su CustomField1 - ListDefinition1.

  7. Nell'elenco di eventi da gestire, controllare la casella accanto a È stato aggiunto un elemento, quindi fare clic su Fine.

  8. Nel nuovo file di codice del ricevitore di eventi è contenuto un solo metodo denominato ItemAdded. Aggiungere codice a questo metodo in modo che a ogni aggiunta di contatti nel relativo elenco venga utilizzato il valore predefinito Scott Brown per l'opzione Nome paziente. A tal fine, sostituire il metodo ItemAdded esistente con quanto riportato di seguito:

    Public Overrides Sub ItemAdded(ByVal properties As SPItemEventProperties)
    properties.ListItem("Patient Name") = "Scott Brown"
    properties.ListItem.Update()
    MyBase.ItemAdded(properties)
End Sub

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

  9. Premere F5 per eseguire il codice e visualizzare il sito di SharePoint nel browser.

  10. Dalla barra Avvio veloce scegliere CustomField1 - ListInstance1.

    Si tratta dell'istanza di elenco per la definizione di elenco. Notare che il campo Nome paziente non viene ancora visualizzato come una colonna dell'istanza di elenco.

  11. Scegliere Elenco dalla scheda Strumenti elenco nella parte superiore della pagina, quindi fare clic sul pulsante Modifica visualizzazione nella barra multifunzione.

  12. Nell'elenco di nomi di colonne disponibili selezionare Nome paziente, quindi scegliere OK. Notare che il campo Nome paziente adesso viene visualizzato nell'istanza di elenco.

  13. Nella scheda Strumenti elenco nella parte superiore della pagina fare clic su Elementi, quindi sul pulsante Nuovo elemento per visualizzare il form di immissione dati.

  14. Immettere i dati nei campi, quindi fare clic sul pulsante Salva nella nuova finestra di dialogo dell'elemento dell'istanza di elenco.

    La colonna Nome paziente viene automaticamente compilata con Scott Brown dopo aver selezionato OK.

Vedere anche

Altre risorse

Sviluppo di soluzioni SharePoint