Gewusst wie: Hinzufügen einer Updater-Methode

Sie können es Benutzern ermöglichen, Geschäftsdaten in einer externen SharePoint-Liste zu aktualisieren, indem Sie eine Updater-Methode erstellen. Weitere Informationen finden Sie unter Entwerfen eines Business Data Connectivity-Modells.

So erstellen Sie eine Updater-Methode

1. Wählen Sie im BDC-Designer eine Entität aus.

2. Klicken Sie im Menü Ansicht auf Weitere Fenster und dann auf BDC-Methodendetails.

   Das Fenster BDC-Methodendetails wird geöffnet. Weitere Informationen über dieses Fenster finden Sie unter Übersicht über Entwurfstools für BDC-Modelle.

3. Wählen Sie im Fenster BDC-Methodendetails in der Dropdownliste Methode hinzufügen den Eintrag Updater-Methode erstellen aus.

   Mit Visual Studio werden dem Modell die folgenden Elemente hinzugefügt. Diese Elemente werden im Fenster BDC-Methodendetails angezeigt.

   • Eine Methode mit dem Namen Aktualisieren.

   • Ein Eingabeparameter für die Methode.

   • Ein Typdeskriptor für den Parameter. Standardmäßig verwendet Visual Studio den Entitätstypdeskriptor, den Sie für die Finder-Methode definiert haben (zum Beispiel: Kontakt).

   • Eine Methodeninstanz für die Methode.

   Weitere Informationen finden Sie unter Entwerfen eines Business Data Connectivity-Modells.

   Tipp

   Wenn der Bezeichner des Entitätstyps ein Feld in einer Datenbanktabelle darstellt, die nicht automatisch generiert wird, legen Sie die Eigenschaft Pre-Updater-Feld auf True fest.

4. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Dienstcodedatei, die für die Entität generiert wurde, und klicken Sie dann auf Code anzeigen.

   Die Codedatei für den Entitätsdienst wird im Code-Editor geöffnet. Weitere Informationen zur Codedatei für den Entitätsdienst finden Sie unter Erstellen eines Business Data Connectivity-Modells.

5. Fügen Sie der Updater-Methode Code hinzu, um Daten zu aktualisieren. Im folgenden Beispiel werden Informationen für einen Kontakt in der AdventureWorks-Beispieldatenbank für SQL Server aktualisiert.

   Tipp

   Ersetzen Sie den Wert des Felds ServerName durch den Namen Ihres Servers.

   Public Shared Sub Update(ByVal contact As Contact)
       Const ServerName As String = "MySQLServerName"
       Dim dataContext As AdventureWorksDataContext = _
           New AdventureWorksDataContext("Data Source=" & ServerName & _
               ";Initial Catalog=AdventureWorks;Integrated Security=True")
   
       Dim ContactToUpdate As Contact = (From Contacts In dataContext.Contacts.AsEnumerable().Take(20) _
            Where Contacts.ContactID = contact.ContactID _
            Select Contacts).Single()
   
       With ContactToUpdate
           .FirstName = contact.FirstName
           .LastName = contact.LastName
           .EmailAddress = contact.EmailAddress
           .Phone = contact.Phone
           .EmailPromotion = contact.EmailPromotion
           .NameStyle = contact.NameStyle
           .PasswordHash = contact.PasswordHash
           .PasswordSalt = contact.PasswordSalt
       End With
   
       dataContext.SubmitChanges()
   
   End Sub
   

   public static void Update(Contact contact)
   {
       const string ServerName = "MySQLServerName";
       AdventureWorksDataContext dataContext = new AdventureWorksDataContext
             ("Data Source=" + ServerName + ";" +
              "Initial Catalog=AdventureWorks;Integrated Security=True");
   
       var contactToUpdate = (from contacts in dataContext.Contacts
                               where contacts.ContactID == contact.ContactID
                               select contacts).Single();
   
       contactToUpdate.FirstName = contact.FirstName;
       contactToUpdate.LastName = contact.LastName;
       contactToUpdate.EmailAddress = contact.EmailAddress;
       contactToUpdate.Phone = contact.Phone;
       contactToUpdate.EmailPromotion = contact.EmailPromotion;
       contactToUpdate.NameStyle = contact.NameStyle;
       contactToUpdate.PasswordHash = contact.PasswordHash;
       contactToUpdate.PasswordSalt = contact.PasswordSalt;
       contactToUpdate.ModifiedDate = DateTime.Now;
       contactToUpdate.rowguid = Guid.NewGuid();
       dataContext.SubmitChanges();
   
   }
   

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen einer Finder-Methode

Gewusst wie: Hinzufügen einer bestimmten Finder-Methode

Gewusst wie: Hinzufügen einer Creator-Methode

Gewusst wie: Hinzufügen einer Updater-Methode

Gewusst wie: Hinzufügen einer Deleter-Methode

Gewusst wie: Hinzufügen eines Parameters zu einer Methode

Gewusst wie: Definieren einer Methodeninstanz

Konzepte

Übersicht über Entwurfstools für BDC-Modelle

Weitere Ressourcen

Entwerfen eines Business Data Connectivity-Modells