SqlCommandBuilder.GetInsertCommand Metoda

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

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

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

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

Public Function GetInsertCommand () As SqlCommand

Zwraca

Automatycznie wygenerowany SqlCommand obiekt wymagany do wykonania 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ć CommandTimeout wartość, a następnie jawnie ustawić ją na .SqlDataAdapter

Po pierwszym wygenerowaniu instrukcji Języka Transact-SQL aplikacja musi jawnie wywołać RefreshSchema metodę , jeśli w jakikolwiek sposób zmieni instrukcję. 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 Update metodę lub GetInsertCommand.

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

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

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

member this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommand

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

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Parametry

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ć CommandTimeout wartość, a następnie jawnie ustawić ją na .SqlDataAdapter

Po pierwszym wygenerowaniu instrukcji Języka Transact-SQL aplikacja musi jawnie wywołać RefreshSchema metodę , jeśli w jakikolwiek sposób zmieni instrukcję. 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 Update metodę lub GetInsertCommand.

Zachowaniem domyślnym podczas generowania nazw parametrów jest użycie @p1parametrów , @p2itd. dla różnych parametrów. Przekazanie 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 ParameterNamePattern zwracanym wywołaniu metody GetSchema i znalezione w wyrażeniu regularnym DataSourceInformation kolekcji.

• Jest ParameterMarkerFormat określony element zwrócony z wywołania metody GetSchema i znaleziony DataSourceInformation w kolekcji.

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