DataContext-Methoden (O/R Designer)

DataContext Methoden (im Kontext der LINQ to SQL Tools in Visual Studio) sind Methoden der DataContext Klasse, die gespeicherte Prozeduren und Funktionen in einer Datenbank ausführen.

Die DataContext Klasse ist eine LINQ to SQL-Klasse, die als Verbindung zwischen einer SQL Server-Datenbank und der LINQ to SQL-Entitätsklassen fungiert, die dieser Datenbank zugeordnet sind. Die DataContext Klasse enthält die Verbindungszeichenfolgeninformationen und die Methoden zum Herstellen einer Verbindung mit einer Datenbank und zum Bearbeiten der Daten in der Datenbank. Standardmäßig enthält die DataContext Klasse mehrere Methoden, die Sie aufrufen können, z. B. die SubmitChanges Methode, die aktualisierte Daten von LINQ an SQL-Klassen an die Datenbank sendet. Sie können auch zusätzliche DataContext Methoden erstellen, die gespeicherten Prozeduren und Funktionen zugeordnet sind. Mit anderen Worten, das Aufrufen dieser benutzerdefinierten Methoden führt die gespeicherte Prozedur oder Funktion in der Datenbank aus, der die DataContext Methode zugeordnet ist. Sie können der Klasse neue Methoden DataContext hinzufügen, genau wie Methoden zum Erweitern einer beliebigen Klasse. In Diskussionen über DataContext-Methoden im Kontext des O/R-Designers werden speziell die DataContext-Methoden besprochen, die gespeicherten Prozeduren und Funktionen zugeordnet sind.

Bereich "Methoden"

DataContext Methoden, die gespeicherten Prozeduren und Funktionen zugeordnet sind, werden im Bereich "Methoden " des O/R-Designers angezeigt. Der Bereich "Methoden " ist der Bereich entlang der Seite des Bereichs " Entitäten " (die Hauptentwurfsoberfläche). Im Bereich "Methoden " werden alle DataContext Methoden aufgelistet, die Sie mithilfe des O/R-Designers erstellt haben. Standardmäßig ist der Bereich "Methoden " leer; Ziehen Sie gespeicherte Prozeduren oder Funktionen aus dem Server-Explorer oder Datenbank-Explorer in den O/R-Designer , um Methoden zu erstellen DataContext und den Bereich "Methoden" aufzufüllen . Weitere Informationen finden Sie unter So erstellen Sie DataContext-Methoden, die gespeicherten Prozeduren und Funktionen zugeordnet sind (O/R-Designer).

Zwei Arten von DataContext-Methoden

DataContext-Methoden sind diese Methoden, die gespeicherten Prozeduren und Funktionen in der Datenbank zugeordnet sind. Sie können DataContext-Methoden im Bereich "Methoden " des O/R-Designers erstellen und hinzufügen. Es gibt zwei unterschiedliche Typen von DataContext-Methoden: jene, die eine oder mehrere Ergebnismengen zurückgeben, und jene, die dies nicht tun.

• DataContext Methoden, die ein oder mehrere Resultsets zurückgeben:

  Erstellen Sie diese Art von DataContext Methode, wenn Ihre Anwendung nur gespeicherte Prozeduren und Funktionen in der Datenbank ausführen und die Ergebnisse zurückgeben muss. Weitere Informationen finden Sie unter How to: Create DataContext methods mapped to stored procedures and functions (O/R Designer), System.Data.Linq.ISingleResult<T> und IMultipleResults.

• DataContext Methoden, die keine Resultsets zurückgeben: z. B. Inserts, Updates und Deletes für eine bestimmte Entitätsklasse.

  Erstellen Sie diese Art von DataContext Methode, wenn Ihre Anwendung gespeicherte Prozeduren ausführen muss, anstatt das Standardmäßige LINQ to SQL-Verhalten zum Speichern geänderter Daten zwischen einer Entitätsklasse und der Datenbank zu verwenden. Weitere Informationen finden Sie unter Zuweisen von gespeicherten Prozeduren für Updates, Einfügungen und Löschungen (O/R-Designer).

Rückgabetypen von DataContext-Methoden

Wenn Sie gespeicherte Prozeduren und Funktionen aus dem Server-Explorer oder Datenbank-Explorer in den O/R-Designer ziehen, unterscheidet sich der Rückgabetyp der generierten DataContext Methode je nachdem, wo Sie das Element ablegen. Durch direktes Ablegen der Elemente auf eine vorhandene Entitätsklasse wird eine DataContext Methode mit dem Rückgabetyp der Entitätsklasse erstellt. Durch das Ablegen von Elementen in einem leeren Bereich des O/R-Designers (in beiden Bereichen) wird eine DataContext Methode erstellt, die einen automatisch generierten Typ zurückgibt. Der automatisch generierte Typ weist den Namen auf, der mit dem gespeicherten Prozedur- oder Funktionsnamen und den Eigenschaften übereinstimmt, die den von der gespeicherten Prozedur oder Funktion zurückgegebenen Feldern zugeordnet sind.

Objekte, die Sie aus der Datenbank auf die O/R Designer-Oberfläche ziehen, werden basierend auf dem Namen der Objekte in der Datenbank automatisch benannt. Wenn Sie dasselbe Objekt mehrmals ziehen, wird am Ende des neuen Namens eine Zahl hinzugefügt, die die Namen unterscheidet. Wenn Datenbankobjektnamen Leerzeichen oder Zeichen enthalten, die in Visual Basic oder C# nicht unterstützt werden, wird das Leerzeichen oder ungültige Zeichen durch einen Unterstrich ersetzt.

Verwandte Inhalte

• LINQ to SQL-Tools in Visual Studio
• LINQ to SQL
• Gespeicherte Prozeduren
• Vorgehensweise: Erstellen von DataContext-Methoden, die gespeicherten Prozeduren und Funktionen zugeordnet sind (O/R Designer)
• Vorgehensweise: Zuweisen gespeicherter Prozeduren zum Ausführen von Aktualisierungen, Einfügen und Löschen (O/R Designer)
• Exemplarische Vorgehensweise: Anpassen des Einfüge-, Aktualisierungs- und Löschverhaltens von Entitätsklassen
• Einführung: Erstellen von LINQ to SQL-Klassen (O-R Designer)