SqlConnection.PacketSize 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得用來與 SQL Server 執行個體通訊的網路封包大小 (位元組)。
public:
property int PacketSize { int get(); };
public int PacketSize { get; }
[System.Data.DataSysDescription("SqlConnection_PacketSize")]
public int PacketSize { get; }
member this.PacketSize : int
[<System.Data.DataSysDescription("SqlConnection_PacketSize")>]
member this.PacketSize : int
Public ReadOnly Property PacketSize As Integer
屬性值
網路封包的大小 (位元組)。 預設值為 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 概觀 \(部分機器翻譯\)