Поделиться через

SqlCeRemoteDataAccess.SubmitSql Method

  • Статья

Отправляет инструкции SQL на выполнение в базу данных SQL Server на удаленном сервере. Отправляет инструкции SQL на выполнение в базу данных SQL Server на удаленном сервере.

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в system.data.sqlserverce.dll)

Синтаксис

'Декларация
Public Sub SubmitSql ( _
    sqlString As String, _
    oleDBConnectionString As String _
)

public void SubmitSql (
    string sqlString,
    string oleDBConnectionString
)

public:
void SubmitSql (
    String^ sqlString, 
    String^ oleDBConnectionString
)

public void SubmitSql (
    String sqlString, 
    String oleDBConnectionString
)

public function SubmitSql (
    sqlString : String, 
    oleDBConnectionString : String
)

Параметры

  • sqlString
    Любая инструкция SQL, которая не возвращает строк.
  • oleDBConnectionString
    Строка соединения OLE DB для удаленной базы данных SQL Server.

Замечания

Свойство InternetUrl должно содержать URL-адрес агента сервера SQL Server Compact 3.5.

Свойства InternetLogin и InternetPassword являются обязательными, если агент сервера SQL Server Compact 3.5 настроен для использования обычной проверки подлинности или встроенной проверки подлинности Windows.

При использовании проверки подлинности SQL Server пользователь, указанный в oledbConnectionString, должен иметь права на чтение таблицы SQL Server.

Если в свойстве oledbConnectionString указан параметр «INTEGRATED SECURITY="SSPI"», выбирающий использование проверки подлинности Windows, то пользователь Интернета должен иметь права на чтение таблицы SQL Server. Идентификация пользователя Интернета в зависимости от способа проверки подлинности производится следующим образом.

  • Если виртуальный каталог служб Microsoft IIS настроен для анонимного доступа, то пользователю Интернета выделяется идентификатор учетной записи гостя из сети Интернет (IUSR_имя_компьютера). Если в качестве учетной записи гостя из сети Интернет настроена другая учетная запись Windows, то пользователь Интернета получит идентификатор этой учетной записи.

  • Если виртуальный каталог IIS настроен для использования обычной проверки подлинности, то пользователь Интернета получает идентификатор учетной записи Windows, для которой клиент указал имя пользователя и пароль в Интернете.

  • Если виртуальный каталог IIS настроен для использования встроенной проверки подлинности Windows, то пользователь Интернета получит идентификатор учетной записи Windows, для которой клиент указал имя пользователя Интернета и пароль.

Замечания

Свойство InternetUrl должно содержать URL-адрес агента сервера SQL Server Compact 3.5.

Свойства InternetLogin и InternetPassword являются обязательными, если агент сервера SQL Server Compact 3.5 настроен для использования обычной проверки подлинности или встроенной проверки подлинности Windows.

При использовании проверки подлинности SQL Server пользователь, указанный в oledbConnectionString, должен иметь права на чтение таблицы SQL Server.

Если в свойстве oledbConnectionString указан параметр «INTEGRATED SECURITY="SSPI"», выбирающий использование проверки подлинности Windows, то пользователь Интернета должен иметь права на чтение таблицы SQL Server. Идентификация пользователя Интернета в зависимости от способа проверки подлинности производится следующим образом.

  • Если виртуальный каталог служб Microsoft IIS настроен для анонимного доступа, то пользователю Интернета выделяется идентификатор учетной записи гостя из сети Интернет (IUSR_имя_компьютера). Если в качестве учетной записи гостя из сети Интернет настроена другая учетная запись Windows, то пользователь Интернета получит идентификатор этой учетной записи.

  • Если виртуальный каталог IIS настроен для использования обычной проверки подлинности, то пользователь Интернета получает идентификатор учетной записи Windows, для которой клиент указал имя пользователя и пароль в Интернете.

  • Если виртуальный каталог IIS настроен для использования встроенной проверки подлинности Windows, то пользователь Интернета получит идентификатор учетной записи Windows, для которой клиент указал имя пользователя Интернета и пароль.

Пример

Следующий пример демонстрирует создание объекта SqlCeRemoteDataAccess, установку некоторых свойств и вызов метода SubmitSql.

' Connection String to the SQL Server
'
Dim rdaOleDbConnectString As String = "Data Source=MySqlServer;Initial Catalog=AdventureWorks; " & _
    "User Id=username;Password = <password>"

' Initialize RDA Object
'
Dim rda As SqlCeRemoteDataAccess = Nothing

Try
    ' Try the SubmitSql Operation
    '
    rda = New SqlCeRemoteDataAccess()

    rda.InternetLogin = "MyLogin"
    rda.InternetPassword = "<password>"
    rda.InternetUrl = "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll"
    rda.LocalConnectionString = "Data Source=MyDatabase.sdf"

    rda.SubmitSql("CREATE TABLE MyRemoteTable (colA int)", rdaOleDbConnectString)
Catch
    ' Handle errors here
    '
Finally
    'Dispose of the RDA object
    '
    rda.Dispose()
End Try

// Connection String to the SQL Server
//
string rdaOleDbConnectString = "Data Source=MySqlServer;Initial Catalog=AdventureWorks; " +
    "User Id=username;Password = <password>";

// Initialize RDA Object
//
SqlCeRemoteDataAccess rda = null;

try
{
    // Try the SubmitSql Operation
    //
    rda = new SqlCeRemoteDataAccess();

    rda.InternetLogin = "MyLogin";
    rda.InternetPassword = "<password>";
    rda.InternetUrl = "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll";
    rda.LocalConnectionString = "Data Source=MyDatabase.sdf";

    rda.SubmitSql("CREATE TABLE MyRemoteTable (colA int)", rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    //Dispose of the RDA object
    //
    rda.Dispose();
}

Пример

Следующий пример демонстрирует создание объекта SqlCeRemoteDataAccess, установку некоторых свойств и вызов метода SubmitSql.

' Connection String to the SQL Server
'
Dim rdaOleDbConnectString As String = "Data Source=MySqlServer;Initial Catalog=AdventureWorks; " & _
    "User Id=username;Password = <password>"

' Initialize RDA Object
'
Dim rda As SqlCeRemoteDataAccess = Nothing

Try
    ' Try the SubmitSql Operation
    '
    rda = New SqlCeRemoteDataAccess()

    rda.InternetLogin = "MyLogin"
    rda.InternetPassword = "<password>"
    rda.InternetUrl = "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll"
    rda.LocalConnectionString = "Data Source=MyDatabase.sdf"

    rda.SubmitSql("CREATE TABLE MyRemoteTable (colA int)", rdaOleDbConnectString)
Catch
    ' Handle errors here
    '
Finally
    'Dispose of the RDA object
    '
    rda.Dispose()
End Try

// Connection String to the SQL Server
//
string rdaOleDbConnectString = "Data Source=MySqlServer;Initial Catalog=AdventureWorks; " +
    "User Id=username;Password = <password>";

// Initialize RDA Object
//
SqlCeRemoteDataAccess rda = null;

try
{
    // Try the SubmitSql Operation
    //
    rda = new SqlCeRemoteDataAccess();

    rda.InternetLogin = "MyLogin";
    rda.InternetPassword = "<password>";
    rda.InternetUrl = "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll";
    rda.LocalConnectionString = "Data Source=MyDatabase.sdf";

    rda.SubmitSql("CREATE TABLE MyRemoteTable (colA int)", rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    //Dispose of the RDA object
    //
    rda.Dispose();
}

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeRemoteDataAccess Class
SqlCeRemoteDataAccess Members
System.Data.SqlServerCe Namespace