SqlCommandBuilder.GetInsertCommand Metod

Källa:

System.Data.SqlClient.notsupported.cs

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();

public System.Data.SqlClient.SqlCommand GetInsertCommand();

member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand () As SqlCommand

Returer

Det automatiskt genererade SqlCommand objekt som krävs för att utföra infogningar.

Kommentarer

Ett program kan använda GetInsertCommand metoden i informations- eller felsökningssyfte eftersom det returnerar objektet SqlCommand som ska köras.

Du kan också använda GetInsertCommand som grund för ett ändrat kommando. Du kan till exempel anropa GetInsertCommand och ändra CommandTimeout värdet och sedan uttryckligen ange det på SqlDataAdapter.

När Transact-SQL-instruktionen först har genererats måste programmet uttryckligen anropa RefreshSchema om instruktionen ändras på något sätt. Annars GetInsertCommand kommer fortfarande att använda information från föregående -instruktion, vilket kanske inte är korrekt. Transact-SQL-instruktionerna genereras först när programmet anropar antingen Update eller GetInsertCommand.

Mer information finns i Generera kommandon med CommandBuilders.

Se även

• Ansluta och hämta data i ADO.NET
• Använder .NET Framework Data Provider för SQL Server
• översikt över ADO.NET

Källa:

System.Data.SqlClient.notsupported.cs

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetInsertCommand(bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Parametrar

Returer

Det automatiskt genererade SqlCommand objektet som krävs för att utföra infogningar.

Kommentarer

Ett program kan använda GetInsertCommand metoden i informations- eller felsökningssyfte eftersom det returnerar objektet SqlCommand som ska köras.

Du kan också använda GetInsertCommand som grund för ett ändrat kommando. Du kan till exempel anropa GetInsertCommand och ändra CommandTimeout värdet och sedan uttryckligen ange det på SqlDataAdapter.

När Transact-SQL-instruktionen först har genererats måste programmet uttryckligen anropa RefreshSchema om instruktionen ändras på något sätt. Annars GetInsertCommand kommer fortfarande att använda information från föregående -instruktion, vilket kanske inte är korrekt. Transact-SQL-instruktionerna genereras först när programmet anropar antingen Update eller GetInsertCommand.

Standardbeteendet när du genererar parameternamn är att använda @p1, @p2och så vidare för de olika parametrarna. Genom att skicka true för parametern useColumnsForParameterNames kan du framtvinga OleDbCommandBuilder att parametrarna genereras baserat på kolumnnamnen i stället. Detta lyckas endast om följande villkor uppfylls:

• Det ParameterNameMaxLength returnerade från GetSchema-metodanropetDataSourceInformation och som hittades i samlingen har angetts och dess längd är lika med eller större än det genererade parameternamnet.

• Det genererade parameternamnet uppfyller de villkor som anges i ParameterNamePattern det returnerade från GetSchema-metodanropet och finns i samlingens reguljära DataSourceInformation uttryck.

• Ett ParameterMarkerFormat som returneras från GetSchema-metodanropet och som finns i DataSourceInformation samlingen har angetts.

Mer information finns i Generera kommandon med CommandBuilders.

Se även

• Ansluta och hämta data i ADO.NET
• Använder .NET Framework Data Provider för SQL Server
• översikt över ADO.NET