LinqDataSourceContextEventArgs.ObjectInstance Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtient ou définit l’objet de contexte de données à créer.

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é

Object

Objet de contexte de données que vous avez défini sur la ObjectInstance propriété ; 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, appelez 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 d’instance du type spécifié dans la ContextTypeName propriété, car cette instance est créée après l’événement ContextCreating . 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.