LinqDataSource.ContextTypeName Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Ruft den Namen des Typs mit der Eigenschaft ab, deren Wert die abzurufenden Daten aufweist, oder legt diesen fest.

public:
 virtual property System::String ^ ContextTypeName { System::String ^ get(); void set(System::String ^ value); };

public override string ContextTypeName { get; set; }

member this.ContextTypeName : string with get, set

Public Overrides Property ContextTypeName As String

Eigenschaftswert

String

Der Name der Klasse, von der Daten abgerufen werden sollen.

Beispiele

Das folgende Beispiel zeigt, wie die ContextTypeName -Eigenschaft auf eine Klasse festgelegt wird, die ein Array von Zeichenfolgen enthält. Außerdem wird gezeigt, wie die Eigenschaft auf eine Klasse festgelegt wird (vom O/R-Designer generiert), die eine Datenbank darstellt.

<!-- Retrieve and display data from array of string values -->
<asp:LinqDataSource 
    ContextTypeName="MovieLibrary" 
    TableName="AvailableGenres" 
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DropDownList 
    DataSourceID="LinqDataSource1"
    runat="server" 
    ID="DropDownList1">
</asp:DropDownList>

<!-- Retrieve and display data from database -->
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Movies" 
    Select="Title"
    ID="LinqDataSource2" 
    runat="server">
</asp:LinqDataSource>
<asp:DropDownList 
    DataSourceID="LinqDataSource2"
    runat="server" 
    ID="DropDownList2">
</asp:DropDownList>

<!-- Retrieve and display data from array of string values -->
<asp:LinqDataSource 
    ContextTypeName="MovieLibrary" 
    TableName="AvailableGenres" 
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DropDownList 
    DataSourceID="LinqDataSource1"
    runat="server" 
    ID="DropDownList1">
</asp:DropDownList>

<!-- Retrieve and display data from database -->
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Movies" 
    Select="Title"
    ID="LinqDataSource2" 
    runat="server">
</asp:LinqDataSource>
<asp:DropDownList 
    DataSourceID="LinqDataSource2"
    runat="server" 
    ID="DropDownList2">
</asp:DropDownList>

Die Klasse namens ExampleDataContext , die die Datenbanktabelle darstellt, wird in diesem Beispiel nicht angezeigt. Damit dieses Beispiel funktioniert, müssen Sie diese Klasse erstellen, indem Sie eine LINQ To SQL-Klasse namens Example.dbml hinzufügen und eine Tabelle mit dem Namen Movie auf den O/R-Designer ziehen. Eine Klasse mit dem Namen ExampleDataContext einer Eigenschaft namens Movies wird generiert.

Das folgende Beispiel zeigt die Klasse namens MovieLibrary , auf die LinqDataSource im Steuerelement verwiesen wird.

public class MovieLibrary
{
    string[] _availableGenres = { "Comedy", "Drama", "Romance" };

    public MovieLibrary()
    {
    }

    public string[] AvailableGenres
    {
        get
        {
            return _availableGenres;
        }
    }
}

Public Class MovieLibrary
    Dim _availableGenres() As String = {"Comedy", "Drama", "Romance"}

    Public ReadOnly Property AvailableGenres() As String()
        Get
            Return _availableGenres
        End Get
    End Property
    
End Class

Hinweise

Wenn Sie das LinqDataSource -Steuerelement verwenden, um Daten aus einer In-Memory-Datensammlung oder einer Datenbank abzurufen, müssen Sie zwei Eigenschaften angeben. Die erste ist eine Datenkontextklasse, die die Datenquelle darstellt. Die zweite ist eine Eigenschaft in der Datenkontextklasse, die die Daten enthält. Sie legen die ContextTypeName -Eigenschaft auf den Namen der Datenkontextklasse und die TableName -Eigenschaft auf die Datensammlung fest, die die Daten enthält.

Wenn Sie beispielsweise Daten aus einer Datenbank abrufen, legen Sie die ContextTypeName Eigenschaft auf den Namen der Klasse fest, die die Datenbank darstellt. Legen Sie außerdem die TableName -Eigenschaft auf die -Eigenschaft fest, die die Tabelle in der Datenbank darstellt. Um Klassen aus einer Datenbank zu generieren, verwenden Sie den O/R-Designer oder das Hilfsprogramm SqlMetal.exe, um diese Klassen automatisch zu generieren.

Wenn Sie Daten aus einer In-Memory-Datensammlung wie einem Array abrufen, legen Sie die ContextTypeName -Eigenschaft auf den Namen der Klasse fest, die die Arrayeigenschaft enthält. Legen Sie dann die TableName -Eigenschaft auf die Eigenschaft fest, die das Array abruft.

Um automatische Aktualisierungs-, Einfüge- oder Löschvorgänge über das LinqDataSource -Steuerelement zu aktivieren, muss die der ContextTypeName -Eigenschaft zugewiesene Klasse von abgeleitet werden DataContext. Darüber hinaus muss die der TableName -Eigenschaft zugewiesene Eigenschaft von abgeleitet werden Table<TEntity>. Wenn Sie keine automatischen Aktualisierungs-, Einfüge- oder Löschvorgänge aktivieren müssen, können Sie der Eigenschaft den Namen eines beliebigen Klassentyps ContextTypeName zuweisen.

Informationen zum Auswählen von Daten aus einer Instanz einer Klasse finden Sie in der Result -Eigenschaft.

Weitere Informationen

• LINQ to SQL