LinqDataSourceContextEventArgs.ObjectInstance Propriété

public:
 property System::Object ^ ObjectInstance { System::Object ^ get(); void set(System::Object ^ value); };

public object ObjectInstance { get; set; }

member this.ObjectInstance : obj with get, set

Public Property ObjectInstance As Object

Valeur de propriété

Objet de contexte de données que vous avez affecté à la propriété ObjectInstance ; sinon, null. La valeur par défaut est null.

Exemples

L’exemple suivant montre comment créer l’objet de contexte de données en appelant un constructeur sans paramètre dans un gestionnaire d’événements pour l’événement ContextCreating . Le code affecte l’objet personnalisé à la ObjectInstance propriété .

protected void LinqDataSource_ContextCreating(object sender, LinqDataSourceContextEventArgs e)
{
    e.ObjectInstance = new ExampleDataContext(ConfigurationManager.ConnectionStrings["ExampleConnectionString"].ConnectionString);
}

Protected Sub LinqDataSource_ContextCreating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceContextEventArgs)
    e.ObjectInstance = New ExampleDataContext(ConfigurationManager.ConnectionStrings("ExampleConnectionString").ConnectionString)
End Sub

Remarques

Par défaut, le LinqDataSource contrôle crée une instance de la classe spécifiée dans la ContextTypeName propriété . Pour ce faire, il appelle le constructeur sans paramètre de cette classe.

Vous pouvez créer manuellement l’objet pour les opérations de données en gérant l’événement ContextCreating et en définissant la ObjectInstance propriété sur un objet que vous avez créé.

Vous créez l’objet manuellement si vous souhaitez utiliser un constructeur sans paramètre ou si vous souhaitez créer un objet différent de celui spécifié dans la ContextTypeName propriété .

La ObjectInstance propriété ne contient pas de instance du type spécifié dans la ContextTypeName propriété, car cette instance est créée après l’événementContextCreating. La ObjectInstance propriété est utilisée uniquement lorsque vous créez manuellement l’objet de contexte de données pendant l’événement ContextCreating . Lorsque vous mettez à jour, insérez ou supprimez des données, vous devez définir la ObjectInstance propriété sur un objet qui dérive de la DataContext classe .

S’applique à