SqlCeRemoteDataAccess.Push

.NET Framework クラス ライブラリ リファレンス

SqlCeRemoteDataAccess.Push メソッド (String, String)

プルされ、追跡されている SQL Server Mobile のテーブルから元の SQL Server テーブルへ、変更を送り返します。これらの変更は、個々のトランザクションで、個別にサーバーに適用されます。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Sub Push ( _
    localTableName As String, _
    oleDBConnectionString As String _
)

Visual Basic (使用法)

Dim instance As SqlCeRemoteDataAccess
Dim localTableName As String
Dim oleDBConnectionString As String

instance.Push(localTableName, oleDBConnectionString)

C#

public void Push (
    string localTableName,
    string oleDBConnectionString
)

C++

public:
void Push (
    String^ localTableName, 
    String^ oleDBConnectionString
)

J#

public void Push (
    String localTableName, 
    String oleDBConnectionString
)

JScript

public function Push (
    localTableName : String, 
    oleDBConnectionString : String
)

パラメータ

localTableName

取得された SQL Server のレコードを受け取る SQL Server Mobile のテーブルの名前。テーブルが既に存在する場合は、エラーが発生します。

oleDBConnectionString

解説

アプリケーションで Push メソッドを呼び出して、プルされ、追跡されている SQL Server Mobile テーブルから SQL Server テーブルへ、変更を送り返します。アプリケーションでは、RdaTrackOption を TrackingOn または TrackingOnWithIndexes に設定して Pull メソッドを呼び出して、SQL Server Mobile のローカル テーブルを作成しておく必要があります。

oledbConnectionString で、SQL Server に接続するときに使用する接続情報をすべて指定します。

SQL Server 認証を使用する場合は、OLEDBConnectionString で指定したユーザー ID に SQL Server テーブルの読み取り権限が付与されている必要があります。

OLEDBConnectionString に INTEGRATED SECURITY="SSPI" を設定して Windows 認証を使用する場合は、インターネット ユーザーに SQL Server テーブルの読み取り権限が付与されている必要があります。インターネット ユーザーは、次のように認証方法に基づいて識別されます。

• Microsoft Internet Information Services (IIS) の仮想ディレクトリが匿名アクセスを使用するように構成されている場合、インターネット ユーザーは、インターネット ゲスト アカウント (IUSR_computername) の ID で実行されます。別の Windows ユーザー アカウントをインターネット ゲスト アカウントとして構成した場合、インターネット ユーザーはそのアカウントの ID として実行されます。

• IIS の仮想ディレクトリが基本認証を使用するように構成されている場合、インターネット ユーザーは、クライアントから指定されたインターネット ユーザーの名前とパスワードに対応する Windows ユーザー アカウントの ID で実行されます。

• IIS の仮想ディレクトリが統合 Windows 認証を使用するように構成されている場合、インターネット ユーザーは、クライアントから指定されたインターネット ユーザーの名前とパスワードに対応する Windows ユーザー アカウントの ID で実行されます。

Pull メソッドの呼び出し時に errorTableName が指定された場合、Push 中に検出されたエラーは、すべてそのエラー テーブルに記録されます。エラー テーブルの処理方法の詳細については、SQL Server Mobile Books Onlineの「RDA の競合検出および競合解決」を参照してください。

使用例

SqlCeRemoteDataAccess オブジェクトを作成し、いくつかのプロパティを設定して、Push メソッドを呼び出す例を次に示します。

Visual Basic

' 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 Push Operation
    '
    rda = New SqlCeRemoteDataAccess( _
        "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll",
 _
        "Data Source=MyDatabase.sdf")

    rda.InternetLogin = "MyLogin"
    rda.InternetPassword = "<password>"

    rda.Push("MyLocalTable", rdaOleDbConnectString,
 RdaBatchOption.BatchingOn)

    ' or, try this overload:
    '
    ' rda.Push("MyLocalTable", rdaOleDbConnectString)

Catch
    ' Handle errors here
    '
Finally
    ' Dispose of the RDA Object
    '
    rda.Dispose()
End Try

C#

// 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 Push Operation
    //
    rda = new SqlCeRemoteDataAccess(
        "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll"
,
        "Data Source=MyDatabase.sdf");

    rda.InternetLogin = "MyLogin";
    rda.InternetPassword = "<password>";

    rda.Push("MyLocalTable", rdaOleDbConnectString, RdaBatchOption.BatchingOn);

    // or, try this overload:
    //
    // rda.Push("MyLocalTable", rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    // Dispose of the RDA Object
    //
    rda.Dispose();
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeRemoteDataAccess クラス
SqlCeRemoteDataAccess メンバ
System.Data.SqlServerCe 名前空間

SqlCeRemoteDataAccess.Push メソッド

プルされ、追跡されている SQL Server Mobile のテーブルから元の SQL Server テーブルへ、変更を送り返します。これらの変更は、個々のトランザクションで、個別にサーバーに適用されます。
オーバーロードの一覧

名前	説明
SqlCeRemoteDataAccess.Push (String, String)	プルされ、追跡されている SQL Server Mobile のテーブルから元の SQL Server テーブルへ、変更を送り返します。これらの変更は、個々のトランザクションで、個別にサーバーに適用されます。 .NET Compact Framework によってサポートされています。
SqlCeRemoteDataAccess.Push (String, String, RdaBatchOption)	プルされ、追跡されている SQL Server Mobile テーブルから、SQL Server テーブルへ、変更を送り返します。これらの変更は、個別にサーバーに適用するか、または 1 つのトランザクションでバッチ処理できます。 .NET Compact Framework によってサポートされています。

参照

関連項目

SqlCeRemoteDataAccess クラス
SqlCeRemoteDataAccess メンバ
System.Data.SqlServerCe 名前空間

SqlCeRemoteDataAccess.Push メソッド (String, String, RdaBatchOption)

プルされ、追跡されている SQL Server Mobile テーブルから、SQL Server テーブルへ、変更を送り返します。これらの変更は、個別にサーバーに適用するか、または 1 つのトランザクションでバッチ処理できます。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Sub Push ( _
    localTableName As String, _
    oleDBConnectionString As String, _
    batchOption As RdaBatchOption _
)

Visual Basic (使用法)

Dim instance As SqlCeRemoteDataAccess
Dim localTableName As String
Dim oleDBConnectionString As String
Dim batchOption As RdaBatchOption

instance.Push(localTableName, oleDBConnectionString, batchOption)

C#

public void Push (
    string localTableName,
    string oleDBConnectionString,
    RdaBatchOption batchOption
)

C++

public:
void Push (
    String^ localTableName, 
    String^ oleDBConnectionString, 
    RdaBatchOption batchOption
)

J#

public void Push (
    String localTableName, 
    String oleDBConnectionString, 
    RdaBatchOption batchOption
)

JScript

public function Push (
    localTableName : String, 
    oleDBConnectionString : String, 
    batchOption : RdaBatchOption
)

パラメータ

localTableName

取得された SQL Server のレコードを受け取る SQL Server Mobile のテーブルの名前。テーブルが既に存在する場合は、エラーが発生します。

oleDBConnectionString

batchOption

SQL Server テーブルに送り返す変更を 1 つのトランザクションでバッチ処理するか、個別に適用するかを示すオプション。

解説

アプリケーションで Push メソッドを呼び出して、プルされ、追跡されている SQL Server Mobile テーブルから SQL Server テーブルへ、変更を送り返します。アプリケーションでは、RdaTrackOption を TrackingOn または TrackingOnWithIndexes に設定して Pull メソッドを呼び出して、SQL Server Mobile のローカル テーブルを作成しておく必要があります。

oledbConnectionString で、SQL Server に接続するときに使用する接続情報をすべて指定します。

SQL Server 認証を使用する場合は、OLEDBConnectionString で指定したユーザー ID に SQL Server テーブルの読み取り権限が付与されている必要があります。

OLEDBConnectionString に INTEGRATED SECURITY="SSPI" を設定して Windows 認証を使用する場合は、インターネット ユーザーに SQL Server テーブルの読み取り権限が付与されている必要があります。インターネット ユーザーは、次のように認証方法に基づいて識別されます。

• Microsoft Internet Information Services (IIS) の仮想ディレクトリが匿名アクセスを使用するように構成されている場合、インターネット ユーザーは、インターネット ゲスト アカウント (IUSR_computername) の ID で実行されます。別の Windows ユーザー アカウントをインターネット ゲスト アカウントとして構成した場合、インターネット ユーザーはそのアカウントの ID として実行されます。

• IIS の仮想ディレクトリが基本認証を使用するように構成されている場合、インターネット ユーザーは、クライアントから指定されたインターネット ユーザーの名前とパスワードに対応する Windows ユーザー アカウントの ID で実行されます。

• IIS の仮想ディレクトリが統合 Windows 認証を使用するように構成されている場合、インターネット ユーザーは、クライアントから指定されたインターネット ユーザーの名前とパスワードに対応する Windows ユーザー アカウントの ID で実行されます。

Pull メソッドの呼び出し時に errorTableName が指定された場合、Push 中に検出されたエラーは、すべてそのエラー テーブルに記録されます。エラー テーブルの処理方法の詳細については、SQL Server Mobile Books Online の「RDA の競合検出および競合解決」を参照してください。

使用例

SqlCeRemoteDataAccess オブジェクトを作成し、いくつかのプロパティを設定して、Push メソッドを呼び出す例を次に示します。

Visual Basic

' 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 Push Operation
    '
    rda = New SqlCeRemoteDataAccess( _
        "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll",
 _
        "Data Source=MyDatabase.sdf")

    rda.InternetLogin = "MyLogin"
    rda.InternetPassword = "<password>"

    rda.Push("MyLocalTable", rdaOleDbConnectString,
 RdaBatchOption.BatchingOn)

    ' or, try this overload:
    '
    ' rda.Push("MyLocalTable", rdaOleDbConnectString)

Catch
    ' Handle errors here
    '
Finally
    ' Dispose of the RDA Object
    '
    rda.Dispose()
End Try

C#

// 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 Push Operation
    //
    rda = new SqlCeRemoteDataAccess(
        "http://www.adventure-works.com/sqlmobile/sqlcesa30.dll"
,
        "Data Source=MyDatabase.sdf");

    rda.InternetLogin = "MyLogin";
    rda.InternetPassword = "<password>";

    rda.Push("MyLocalTable", rdaOleDbConnectString, RdaBatchOption.BatchingOn);

    // or, try this overload:
    //
    // rda.Push("MyLocalTable", rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    // Dispose of the RDA Object
    //
    rda.Dispose();
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeRemoteDataAccess クラス
SqlCeRemoteDataAccess メンバ
System.Data.SqlServerCe 名前空間