SqlConnection.PacketSize Properti

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Mendapatkan ukuran (dalam byte) paket jaringan yang digunakan untuk berkomunikasi dengan instans SQL Server.

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

public int PacketSize { get; }

member this.PacketSize : int

Public ReadOnly Property PacketSize As Integer

Nilai Properti

Int32

Ukuran (dalam byte) paket jaringan. Nilai defaultnya adalah 8000.

Contoh

Contoh berikut membuat SqlConnection, termasuk mengatur Packet Size ke 512 di string koneksi. Ini menampilkan PacketSize properti dan ServerVersion di jendela konsol.

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

Keterangan

Jika aplikasi melakukan operasi penyalinan massal, atau mengirim atau menerima banyak data teks atau gambar, ukuran paket yang lebih besar dari default dapat meningkatkan efisiensi karena menyebabkan lebih sedikit operasi baca dan tulis jaringan. Jika aplikasi mengirim dan menerima sejumlah kecil informasi, Anda dapat mengatur ukuran paket menjadi 512 byte (menggunakan nilai Ukuran Paket dalam ConnectionString), yang cukup untuk sebagian besar operasi transfer data. Untuk sebagian besar aplikasi, ukuran paket default adalah yang terbaik.

PacketSize mungkin merupakan nilai dalam rentang 512 dan 32767 byte. Pengecualian dihasilkan jika nilai berada di luar rentang ini.

Mengatur nilai default ke angka yang lebih besar dari 8000 akan menyebabkan paket menggunakan alokator MultiPage pada instans SQL Server alih-alih alokator SinglePage yang jauh lebih efisien, mengurangi skalabilitas keseluruhan SQL Server. Untuk informasi selengkapnya tentang cara SQL Server menggunakan memori, lihat Panduan Arsitektur Manajemen Memori.

Lihat juga

• Menyambungkan ke Sumber Data di ADO.NET
• Ringkasan ADO.NET