SqlConnection.PacketSize プロパティ

SQL Server のインスタンスと通信するために使用するネットワーク パケットのサイズ (バイト単位) を取得します。

Public ReadOnly Property PacketSize As Integer
[C#]
public int PacketSize {get;}
[C++]
public: __property int get_PacketSize();
[JScript]
public function get PacketSize() : int;

プロパティ値

ネットワーク パケットのサイズ (バイト単位)。既定値は、8192 です。

解説

アプリケーションが一括コピー操作を実行する場合、または大量のテキスト データやイメージ データを送受信する場合に、既定値よりサイズの大きいパケットを使用すると、ネットワークを経由した読み書き操作が減るため、効率が上がる可能性があります。送受信する情報量が少ないアプリケーションでは、パケット サイズを 512 バイトに設定することもできます (ConnectionString の Packet Size 値を使用します)。このサイズは、大部分のデータ転送操作において十分なサイズです。ほとんどのアプリケーションでは、既定のパケット サイズが最適です。

PacketSize に設定できる値は、512 ～ 32767 バイトです。この範囲外の値を設定すると、例外が生成されます。

使用例

[Visual Basic, C#, C++] パケット サイズを設定して SqlConnection を作成し、その読み取り専用プロパティの一部を表示する例を次に示します。

 
Public Sub CreateSqlConnection()
    Dim myConnectString As String = "Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer;Packet Size=512"
    Dim myConnection As New SqlConnection(myConnectString)
    myConnection.Open()
    MessageBox.Show("ServerVersion: " & myConnection.ServerVersion & ControlChars.Cr & _
                    "PacketSize: " & myConnection.PacketSize.ToString())
    myConnection.Close()
End Sub 'CreateSqlConnection

[C#] 
public void CreateSqlConnection() 
 {
    string myConnectString = "Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer;Packet Size=512";
    SqlConnection myConnection = new SqlConnection(myConnectString);
    myConnection.Open();
    MessageBox.Show("ServerVersion: " + myConnection.ServerVersion + 
                    "\nPacketSize: " + myConnection.PacketSize.ToString());
    myConnection.Close();
 }

[C++] 
public:
void CreateSqlConnection() 
 {
    String* myConnectString = S"Persist Security Info=False;Integrated Security=SSPI;database=northwind;server=mySQLServer;Packet Size=512";
    SqlConnection* myConnection = new SqlConnection(myConnectString);
    myConnection->Open();
    MessageBox::Show(String::Format( S"ServerVersion: {0}\nPacketSize: {1}", myConnection->ServerVersion, __box(myConnection->PacketSize)));
    myConnection->Close();
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SqlConnection クラス | SqlConnection メンバ | System.Data.SqlClient 名前空間