Gewusst wie: Hinzufügen einer Creator-Methode

Mit einer Creator-Methode werden der Datenquelle einer Entität neue Daten hinzugefügt. Der Business Data Connectivity (BDC)-Dienst ruft diese Methode auf, wenn Benutzer im Menüband einer Liste, die auf dem Modell basiert, auf die Schaltfläche Neues Element klicken. Weitere Informationen finden Sie unter Entwerfen eines Business Data Connectivity-Modells.

So fügen Sie eine Creator-Methode hinzu

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 zum Fenster BDC-Methodendetails 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 Creator-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 Create.

   • Ein Eingabeparameter für die Methode.

   • Ein Typdeskriptor für den Parameter.

   • Eine Methodeninstanz für die Methode.

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

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 Creator-Methode Code hinzu, mit dem der Datenquelle Daten hinzugefügt werden. Im folgenden Beispiel wird der AdventureWorks-Beispieldatenbank für SQL Server ein neuer Kontakt hinzugefügt.

   Tipp

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

   Public Shared Function Create(ByVal newContact As Contact) As Contact
       Const ServerName As String = "MySQLServerName"
       Dim dataContext As AdventureWorksDataContext = _
           New AdventureWorksDataContext("Data Source=" & ServerName & _
               ";Initial Catalog=AdventureWorks;Integrated Security=True")
   
       Dim TempContact As New Contact()
   
       With TempContact
           .FirstName = newContact.FirstName
           .LastName = newContact.LastName
           .EmailAddress = newContact.EmailAddress
           .Phone = newContact.Phone
           .EmailPromotion = newContact.EmailPromotion
           .NameStyle = newContact.NameStyle
           .PasswordHash = newContact.PasswordHash
           .PasswordSalt = newContact.PasswordSalt
           .ModifiedDate = DateTime.Now
           .rowguid = Guid.NewGuid()
       End With
   
       dataContext.Contacts.InsertOnSubmit(TempContact)
       dataContext.SubmitChanges()
       Return TempContact
   
   End Function
   

   public static Contact Create(Contact newContact)
   {
       const string ServerName = "MySQLServerName";
       AdventureWorksDataContext dataContext = new AdventureWorksDataContext
             ("Data Source=" + ServerName + ";" +
              "Initial Catalog=AdventureWorks;Integrated Security=True");
   
       Contact contact = new Contact();
   
       contact.FirstName = newContact.FirstName;
       contact.LastName = newContact.LastName;
       contact.EmailAddress = newContact.EmailAddress;
       contact.Phone = newContact.Phone;
       contact.EmailPromotion = newContact.EmailPromotion;
       contact.NameStyle = newContact.NameStyle;
       contact.PasswordHash = newContact.PasswordHash;
       contact.PasswordSalt = newContact.PasswordSalt;
       contact.ModifiedDate = DateTime.Now;
       contact.rowguid = Guid.NewGuid();
   
       dataContext.Contacts.InsertOnSubmit(contact);
       dataContext.SubmitChanges();
       return contact;
   
   }
   

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen einer Finder-Methode

Gewusst wie: Hinzufügen einer bestimmten Finder-Methode

Gewusst wie: Hinzufügen einer Deleter-Methode

Gewusst wie: Hinzufügen einer Updater-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