SqlCommandBuilder.GetInsertCommand Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
Public Function GetInsertCommand () As SqlCommand
Zwraca
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
Dotyczy
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 true
nazwy parametrów pasujących do nazw kolumn. Jeśli false
, wygeneruj @p1
, @p2
i tak dalej.
Zwraca
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 @p1
parametrów , @p2
itd. 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