By default, the LinqDataSource control creates an instance of the type that is specified in the ContextTypeName property. The LinqDataSource control calls the default constructor of the data context object to create an instance of the object.

You can manually create the data context object by handling the ContextCreating event. You do this if you want to use a non-default constructor.

You can also handle the ContextCreating event if you want to create a data context object that is different from the one specified in the ContextTypeName property. In that case, you set the ObjectInstance property to the object you created. The LinqDataSource control will use the object you have created for selecting the data. When you are updating, inserting, or deleting data, you must set the ObjectInstance property to an object that derives from the DataContext class.

The following example shows how to create the data context object by calling a non-default constructor in an event handler for the ContextCreating event. The code assigns the custom object to the ObjectInstance property.

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

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

.NET Framework

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2

Reference

Other Resources

Par défaut, le contrôle LinqDataSource crée une instance du type spécifié dans la propriété ContextTypeName. Le contrôle LinqDataSource appelle le constructeur par défaut de l'objet de contexte de données pour créer une instance de l'objet.

Vous pouvez créer manuellement l'objet de contexte de données en gérant l'événement ContextCreating. Vous procédez ainsi si vous souhaitez utiliser un constructeur autre que celui par défaut.

Vous pouvez également gérer l'événement ContextCreating si vous souhaitez créer un objet de contexte de données différent de celui spécifié dans la propriété ContextTypeName. Dans ce cas, vous affectez comme valeur à la propriété ObjectInstance l'objet que vous avez créé. Le contrôle LinqDataSource utilisera l'objet que vous avez créé pour sélectionner les données. Lorsque vous mettez à jour, insérez ou supprimez des données, vous devez affecter comme valeur à la propriété ObjectInstance un objet qui dérive de la classe DataContext.

L'exemple suivant indique comment créer l'objet de contexte de données en appelant un constructeur autre que celui par défaut dans un gestionnaire d'événements pour l'événement ContextCreating. Le code assigne l'objet personnalisé à la propriété ObjectInstance.

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

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

.NET Framework

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources