SqlCommandBuilder.GetInsertCommand Metoda

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.SqlClient.dll

Pakiet:

System.Data.SqlClient v4.8.6

Pobiera automatycznie wygenerowany SqlCommand obiekt, który jest wymagany do wykonywania wstawiania w bazie danych.

Przeciążenia

GetInsertCommand()	Pobiera automatycznie wygenerowany SqlCommand obiekt wymagany do wykonywania wstawiania w bazie danych.
GetInsertCommand(Boolean)	Pobiera automatycznie wygenerowany SqlCommand obiekt, który jest wymagany do wykonywania wstawiania w bazie danych.

Uwagi

Aplikacja może używać GetInsertCommand metody do celów informacyjnych lub rozwiązywania problemów, ponieważ zwraca SqlCommand obiekt do wykonania.

Można również użyć GetInsertCommand jako podstawy zmodyfikowanego polecenia. Możesz na przykład wywołać GetInsertCommand i zmodyfikować wartość, a następnie jawnie ustawić CommandTimeout ją na .SqlDataAdapter

Po pierwszym wygenerowaniu instrukcji Transact-SQL aplikacja musi jawnie wywołać RefreshSchema , jeśli zmieni instrukcję w jakikolwiek sposób. GetInsertCommand W przeciwnym razie nadal będzie używać informacji z poprzedniej instrukcji, co może nie być poprawne. Instrukcje języka Transact-SQL są najpierw generowane, gdy aplikacja wywołuje metodę Update lub GetInsertCommand.

Aby uzyskać więcej informacji, zobacz Generowanie poleceń za pomocą poleceń CommandBuilders.

GetInsertCommand()

Pobiera automatycznie wygenerowany SqlCommand obiekt wymagany do wykonywania wstawiania w bazie danych.

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

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

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

Public Function GetInsertCommand () As SqlCommand

Zwraca

SqlCommand

Automatycznie wygenerowany SqlCommand obiekt wymagany do wykonywania wstawiania.

Uwagi

Aplikacja może używać GetInsertCommand metody do celów informacyjnych lub rozwiązywania problemów, ponieważ zwraca SqlCommand obiekt do wykonania.

Można również użyć GetInsertCommand jako podstawy zmodyfikowanego polecenia. Możesz na przykład wywołać GetInsertCommand i zmodyfikować wartość, a następnie jawnie ustawić CommandTimeout ją na .SqlDataAdapter

Po pierwszym wygenerowaniu instrukcji Transact-SQL aplikacja musi jawnie wywołać RefreshSchema , jeśli zmieni instrukcję w jakikolwiek sposób. GetInsertCommand W przeciwnym razie nadal będzie używać informacji z poprzedniej instrukcji, co może nie być poprawne. Instrukcje języka Transact-SQL są najpierw generowane, gdy aplikacja wywołuje metodę Update lub GetInsertCommand.

Aby uzyskać więcej informacji, zobacz Generowanie poleceń za pomocą poleceń CommandBuilders.

Zobacz też

• Łączenie i pobieranie danych w ADO.NET
• Korzystanie z dostawcy danych .NET Framework dla SQL Server
• Omówienie ADO.NET

GetInsertCommand(Boolean)

Pobiera automatycznie wygenerowany SqlCommand obiekt, który jest wymagany do wykonywania wstawiania w bazie danych.

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

Parametry

useColumnsForParameterNames

Boolean

Jeśli to możliwe, wygeneruj truenazwy parametrów pasujących do nazw kolumn. Jeśli false, wygeneruj @p1, @p2i tak dalej.

Zwraca

SqlCommand

Automatycznie wygenerowany SqlCommand obiekt, który jest wymagany do wykonywania wstawiania.

Uwagi

Aplikacja może używać GetInsertCommand metody do celów informacyjnych lub rozwiązywania problemów, ponieważ zwraca SqlCommand obiekt do wykonania.

Można również użyć GetInsertCommand jako podstawy zmodyfikowanego polecenia. Możesz na przykład wywołać GetInsertCommand i zmodyfikować wartość, a następnie jawnie ustawić CommandTimeout ją na .SqlDataAdapter

Po pierwszym wygenerowaniu instrukcji Transact-SQL aplikacja musi jawnie wywołać RefreshSchema , jeśli zmieni instrukcję w jakikolwiek sposób. GetInsertCommand W przeciwnym razie nadal będzie używać informacji z poprzedniej instrukcji, co może nie być poprawne. Instrukcje języka Transact-SQL są najpierw generowane, gdy aplikacja wywołuje metodę Update lub GetInsertCommand.

Domyślne zachowanie podczas generowania nazw parametrów polega na użyciu @p1parametrów , @p2itd. dla różnych parametrów. Przekazywanie true parametru useColumnsForParameterNames pozwala wymusić OleDbCommandBuilder generowanie parametrów na podstawie nazw kolumn. To powiedzie się tylko wtedy, gdy spełnione są następujące warunki:

• Zwrócony ParameterNameMaxLength z wywołania metody GetSchema i znaleziony w DataSourceInformation kolekcji został określony, a jego długość jest równa lub większa niż wygenerowana nazwa parametru.

• Wygenerowana nazwa parametru spełnia kryteria określone w zwróconym ParameterNamePattern wywołaniu metody GetSchema i znalezione w wyrażeniu regularnym DataSourceInformation kolekcji.

• Zwrócony ParameterMarkerFormat z wywołania metody GetSchema i znaleziony DataSourceInformation w kolekcji jest określony.

Aby uzyskać więcej informacji, zobacz Generowanie poleceń za pomocą poleceń CommandBuilders.

Zobacz też

• Łączenie i pobieranie danych w ADO.NET
• Korzystanie z dostawcy danych .NET Framework dla SQL Server
• Omówienie ADO.NET