Comment : ajouter une méthode de créationHow to: Add a Creator Method

Une méthode de création ajoute de nouvelles données à la source de données d’une entité.A Creator method adds new data to the data source of an entity. Le service de connectivité de données métiers (BDC) appelle cette méthode lorsque les utilisateurs choisissent le un nouvel élément bouton sur le ruban d’une liste qui est basée sur le modèle.The Business Data Connectivity (BDC) service calls this method when users choose the New Item button on the Ribbon of a list that is based on the model. Pour plus d’informations, consultez vous concevez un modèle de connectivité de données métiers.For more information, see Designing a Business Data Connectivity Model.

Pour ajouter une méthode de créationTo add a Creator method

  1. Dans le concepteur BDC, choisissez une entité.On the BDC designer, choose an entity.

  2. Dans la barre de menus, choisissez vue, autres fenêtres, détails de méthode BDC.On the menu bar, choose View, Other Windows, BDC Method Details.

    Le détails de méthode BDC fenêtre s’ouvre.The BDC Method Details window opens. Pour plus d’informations sur cette fenêtre, consultez vue d’ensemble des outils de conception modèle BDC.For more information about that window, see BDC Model Design Tools Overview.

  3. Dans le ajouter une méthode , choisissez créer une méthode de créateur.In the Add a Method list, choose Create Creator Method.

    Visual Studio ajoute les éléments suivants au modèle, et ces éléments apparaissent dans le détails de méthode BDC fenêtre.Visual Studio adds the following elements to the model, and these elements appear in the BDC Method Details window.

    • Une méthode nommée créer.A method named Create.

    • Un paramètre d’entrée pour la méthode.An input parameter for the method.

    • Un paramètre de retour de la méthode.A return parameter for the method.

    • Descripteurs pour les paramètres de type.Type descriptors for the parameters.

    • Une instance de méthode pour la méthode.A method instance for the method.

      Pour plus d’informations, consultez vous concevez un modèle de connectivité de données métiers.For more information, see Designing a Business Data Connectivity Model.

  4. Dans l’Explorateur de solutions, ouvrez le menu contextuel du service fichier de code qui a été généré pour l’entité, puis choisissez afficher le Code.In Solution Explorer, open the shortcut menu of the service code file that was generated for the entity, and then choose View Code.

    Le fichier de code de service entité s’ouvre dans l’éditeur de Code.The entity service code file opens in the Code Editor. Pour plus d’informations sur le fichier de code de service entité, consultez création d’un modèle de connectivité de données métiers.For more information about the entity service code file, see Creating a Business Data Connectivity Model.

  5. Ajoutez le code à la méthode de création qui ajoute des données à la source de données.Add code to the Creator method that adds data to the data source. L’exemple suivant ajoute un contact à la base de données AdventureWorks pour SQL Server.The following example adds a contact to the AdventureWorks sample database for SQL Server.

    Note

    Remplacez la valeur de la ServerName champ avec le nom de votre serveur.Replace the value of the ServerName field with the name of your server.

    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;
    
    }
    
    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
    

Voir aussiSee Also

Conception d’un modèle de connectivité de données métiers Designing a Business Data Connectivity Model
Comment : ajouter une méthode de recherche How to: Add a Finder Method
Comment : ajouter une méthode de recherche spécifique How to: Add a Specific Finder Method
Comment : ajouter une méthode de suppression How to: Add a Deleter Method
Comment : ajouter une méthode de mise à jour How to: Add an Updater Method
Présentation des outils de conception modèle BDC BDC Model Design Tools Overview
Comment : ajouter un paramètre à une méthode How to: Add a Parameter to a Method
Guide pratique pour définir une instance de méthodeHow to: Define a Method Instance