LinqDataSourceContextEventArgs.ObjectInstance Proprietà

Definizione

Ottiene o imposta l'oggetto contesto dati da creare.Gets or sets the data context object to create.

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

Valore della proprietà

Oggetto contesto dati impostato sulla proprietà ObjectInstance; in caso contrario, null.The data context object that you have set to the ObjectInstance property; otherwise, null. Il valore predefinito è null.The default is null.

Esempi

Nell'esempio seguente viene illustrato come creare l'oggetto contesto dati chiamando un costruttore senza parametri in un gestore eventi per l' ContextCreating evento.The following example shows how to create the data context object by calling a non-parameterless constructor in an event handler for the ContextCreating event. Il codice assegna l'oggetto personalizzato alla ObjectInstance proprietà.The code assigns the custom object to the ObjectInstance property.

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

Commenti

Per impostazione predefinita, LinqDataSource il controllo crea un'istanza della classe specificata ContextTypeName nella proprietà.By default, the LinqDataSource control creates an instance of the class specified in the ContextTypeName property. Questa operazione viene eseguita chiamando il costruttore senza parametri di tale classe.It does this by calling the parameterless constructor of that class.

È possibile creare manualmente l'oggetto per le operazioni sui dati gestendo l' ContextCreating evento e impostando la ObjectInstance proprietà su un oggetto creato.You can manually create the object for data operations by handling the ContextCreating event and setting the ObjectInstance property to an object you have created.

L'oggetto viene creato manualmente se si desidera utilizzare un costruttore senza parametri o se si desidera creare un oggetto diverso da quello specificato nella ContextTypeName proprietà.You create the object manually if you want to use a non-parameterless constructor or if you want to create an object that is different from the one specified in the ContextTypeName property.

La ObjectInstance proprietà non contiene un'istanza del tipo specificato ContextTypeName nella proprietà, perché tale istanza viene creata dopo l' ContextCreating evento.The ObjectInstance property does not contain an instance of the type specified in the ContextTypeName property, because that instance is created after the ContextCreating event. La ObjectInstance proprietà viene utilizzata solo quando si crea manualmente l'oggetto contesto dati durante l' ContextCreating evento.The ObjectInstance property is used only when you manually create the data context object during the ContextCreating event. Quando si esegue l'aggiornamento, l'inserimento o l'eliminazione di dati, è necessario ObjectInstance impostare la proprietà su un oggetto che deriva DataContext dalla classe.When you are updating, inserting, or deleting data, you must set the ObjectInstance property to an object that derives from the DataContext class.

Si applica a