DataContext.GetCommand, méthode (System.Data.Linq)

Changer de vue:

ScriptFree

Bibliothèque de classes .NET Framework

DataContext.GetCommand, méthode

Cet article a fait l'objet d'une traduction manuelle. Pour afficher simultanément cette page et le contenu source en anglais, choisissez le paramètre d'affichage Basse densité.

Fournit des informations sur les commandes SQL générées par LINQ to SQL.

Espace de noms : System.Data.Linq
Assembly : System.Data.Linq (dans System.Data.Linq.dll)

Syntaxe

Visual Basic

Public Function GetCommand ( _
	query As IQueryable _
) As DbCommand

public DbCommand GetCommand(
	IQueryable query
)

VisualC++

public:
DbCommand^ GetCommand(
	IQueryable^ query
)

member GetCommand : 
        query:IQueryable -> DbCommand

Paramètres

query: Type : System.Linq.IQueryable
Requête dont les informations de commande de SQL sont à récupérer.

Valeur de retour

Type : System.Data.Common.DbCommand
Objet d'informations de la commande demandée.

Notes

Cette méthode est uniquement un accesseur Get et n'affecte pas l'état de DataContext.

Tenez compte des considérations suivantes :

L'argument doit être non null. Sinon, une exception d'argument null est levée.
Les exceptions de traduction de requête normales levées pendant une exécution de requête LINQ to SQL s'appliquent à une requête qui ne peut pas être traduite.
Seule la première commande de requête est retournée. Plus précisément, les commandes supplémentaires utilisées pour le chargement hâtif (LoadWith) ne sont pas incluses.
DataContext n'effectue pas le suivi de ce que l'utilisateur fait de la commande. Par exemple, les résultats de l'exécution de la commande retournée ne font pas l'objet d'un suivi et n'affectent pas l'état de DataContext.

Exemples

Visual Basic


' Imports System.Data.Common
Dim db As New Northwnd("c:\northwnd.mdf")

Dim q = _
From cust In db.Customers _
Where cust.City = "London" _
Select cust

Console.WriteLine("Customers from London:")
For Each z As Customer In q
    Console.WriteLine(vbTab & z.ContactName)
Next

Dim dc As DbCommand = db.GetCommand(q)
Console.WriteLine(vbNewLine & "Command Text: " & vbNewLine & dc.CommandText)
Console.WriteLine(vbNewLine & "Command Type: {0}", dc.CommandType)
Console.WriteLine(vbNewLine & "Connection: {0}", dc.Connection)

Console.ReadLine()


// using System.Data.Common;
Northwnd db = new Northwnd(@"c:\northwnd.mdf");

var q =
    from cust in db.Customers
    where cust.City == "London"
    select cust;

Console.WriteLine("Customers from London:");
foreach (var z in q)
{
    Console.WriteLine("\t {0}",z.ContactName);
}

DbCommand dc = db.GetCommand(q);
Console.WriteLine("\nCommand Text: \n{0}",dc.CommandText);
Console.WriteLine("\nCommand Type: {0}",dc.CommandType);
Console.WriteLine("\nConnection: {0}",dc.Connection);

Console.ReadLine();

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5

.NET Framework Client Profile

Pris en charge dans : 4

Plateformes

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

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Voir aussi

Référence

DataContext Classe

System.Data.Linq, espace de noms