SqlCommandBuilder.GetUpdateCommand Metoda

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

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

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

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

Public Function GetUpdateCommand () As SqlCommand

Zwraca

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

Uwagi

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

Można również użyć GetUpdateCommand jako podstawy zmodyfikowanego polecenia. Możesz na przykład wywołać GetUpdateCommand 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ę. GetUpdateCommand 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 GetUpdateCommand.

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

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

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

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

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

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Parametry

Zwraca

Automatycznie wygenerowany SqlCommand obiekt wymagany do wykonywania aktualizacji.

Uwagi

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

Można również użyć GetUpdateCommand jako podstawy zmodyfikowanego polecenia. Możesz na przykład wywołać GetUpdateCommand 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ę. GetUpdateCommand 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 GetUpdateCommand.

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ń.