SqlConnection.PacketSize 屬性

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.SqlClient.dll

套件:

System.Data.SqlClient v4.8.6

取得用來與 SQL Server 執行個體通訊的網路封包大小 (位元組)。

public:
 property int PacketSize { int get(); };

public int PacketSize { get; }

member this.PacketSize : int

Public ReadOnly Property PacketSize As Integer

屬性值

Int32

網路封包的大小 (位元組)。 預設值為 8000。

範例

下列範例會SqlConnection建立 ，包括將 連接字串 中的 設定Packet Size為512。 它會在主控台視窗中顯示 PacketSize 和 ServerVersion 屬性。

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("PacketSize: {0}", connection.PacketSize);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file, using the
    // System.Configuration.ConfigurationSettings.AppSettings property
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;Packet Size=512";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("PacketSize: {0}", connection.PacketSize)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file, using the
    ' System.Configuration.ConfigurationSettings.AppSettings property
    Return "Data Source=(local);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;Packet Size=512;"
End Function

備註

如果應用程式執行大量複製作業，或傳送或接收大量文字或影像數據，則大於預設值的封包大小可能會提升效率，因為它會造成較少的網路讀取和寫入作業。 如果應用程式傳送和接收少量的資訊，您可以使用) 中的 ConnectionString 封包大小值，將封包大小設定為 512 個字節 (，這足以用於大部分的數據傳輸作業。 對於大部分應用程式而言，預設封包大小是最適當的大小。

PacketSize 可以是512和32767位元組範圍內的值。 如果值超出此範圍，就會產生例外狀況。

將預設值設定為大於 8000 的數位會導致封包在 SQL Server 實例上使用 MultiPage 配置器，而不是更有效率的 SinglePage 配置器，以減少 SQL Server 的整體延展性。 如需 SQL Server 如何使用記憶體的詳細資訊，請參閱記憶體管理架構指南。

另請參閱

• 線上到 ADO.NET 中的數據源
• ADO.NET 概觀 \(部分機器翻譯\)