SqlCeRemoteDataAccess.Push メソッドとは何？わかりやすく解説 Weblio辞書

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

public void Push (
    string localTableName,
    string oleDBConnectionString
)

C++

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

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

// 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.Push メソッド (String, String, RdaBatchOption)

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