LinqDataSourceContextEventArgs.ObjectInstance Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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 .