Dela via


DataContext-metoder (O/R Designer)

DataContext metoder (i samband med LINQ till SQL Tools i Visual Studio) är metoder för klassen DataContext som kör lagrade procedurer och funktioner i en databas.

Klassen DataContext är en LINQ till SQL-klass som fungerar som en kanal mellan en SQL Server-databas och LINQ-till SQL-entitetsklasserna som mappas till databasen. Klassen DataContext innehåller information om anslutningssträngen och metoderna för att ansluta till en databas och ändra data i databasen. Klassen innehåller som standard DataContext flera metoder som du kan anropa, till exempel metoden SubmitChanges som skickar uppdaterade data från LINQ till SQL-klasser till databasen. Du kan också skapa ytterligare DataContext metoder som mappar till lagrade procedurer och funktioner. Med andra ord kör anropet av dessa anpassade metoder den lagrade proceduren eller funktionen i databasen som DataContext metoden mappas till. Du kan lägga till nya metoder i DataContext klassen på samma sätt som du lägger till metoder för att utöka alla klasser. Men i diskussioner om DataContext metoder i samband med O/R Designer är det de DataContext metoder som mappar till lagrade procedurer och funktioner som diskuteras.

Fönstret Metoder

DataContext metoder som mappar till lagrade procedurer och funktioner visas i fönstret Metoder i O/R Designer. Fönstret Metoder är fönstret längs sidan av fönstret Entiteter (huvuddesignytan). I fönstret Metoder visas alla DataContext metoder som du har skapat med hjälp av O/R Designer. Som standard är fönstret Metoder tomt. dra lagrade procedurer eller funktioner från Server Explorer eller Database Explorer till O/R Designer för att skapa DataContext metoder och fylla i fönstret Metoder . Mer information finns i Hur man: Skapar DataContext-metoder som är kopplade till lagrade procedurer och funktioner (O/R Designer).

Anmärkning

Öppna och stäng metodfönstret genom att högerklicka på O/R Designer och sedan klicka på Fönstret Dölj metoder eller Fönstret Visa metoder, eller använd kortkommandot CTRL+1.

Två typer av DataContext-metoder

DataContext-metoder är de metoder som mappar till lagrade procedurer och funktioner i databasen. Du kan skapa och lägga till DataContext-metoder i fönstret Metoder i O/R Designer. Det finns två olika typer av DataContext metoder: de som returnerar en eller flera resultatuppsättningar och de som inte gör det:

Returnera typer av DataContext-metoder

När du drar lagrade procedurer och funktioner från Server Explorer eller Database Explorer till O/R Designer skiljer sig returtypen för den genererade DataContext metoden åt beroende på var du släpper objektet. Om du släpper objekten direkt till en befintlig entitetsklass skapas en DataContext metod med returtypen för entitetsklassen. Om du släpper objekt till ett tomt område i O/R Designer (i båda fönsterrutorna) skapas en DataContext metod som returnerar en automatiskt genererad typ. Den automatiskt genererade typen har det namn som matchar den lagrade proceduren eller funktionsnamnet och egenskaperna, som mappas till fälten som returneras av den lagrade proceduren eller funktionen.

Anmärkning

Du kan ändra returtypen för en DataContext metod när du har lagt till den i metodfönstret. Om du vill granska eller ändra returtypen för en DataContext metod väljer du den och inspekterar egenskapen Returtyp i fönstret Egenskaper . Mer information finns i How to: Change the return type of a DataContext method (O/R Designer).

Objekt som du drar från databasen till O/R Designer-ytan namnges automatiskt, baserat på namnet på objekten i databasen. Om du drar samma objekt mer än en gång läggs ett tal till i slutet av det nya namnet som särskiljer namnen. När databasobjektnamn innehåller blanksteg eller tecken som inte stöds i Visual Basic eller C# ersätts blanksteget eller det ogiltiga tecknet med ett understreck.