StreamSocket.ConnectAsync Metode

Definisi

Ruang nama:

Windows.Networking.Sockets

Overload

ConnectAsync(EndpointPair)	Memulai operasi asinkron pada objek StreamSocket untuk menyambungkan ke tujuan jaringan jarak jauh yang ditentukan sebagai objek EndpointPair .
ConnectAsync(EndpointPair, SocketProtectionLevel)	Memulai operasi asinkron pada objek StreamSocket untuk terhubung ke tujuan jaringan jarak jauh yang ditentukan sebagai objek EndpointPair dan enumerasi SocketProtectionLevel . Metode ini tidak dapat dipanggil dari JavaScript.
ConnectAsync(HostName, String)	Memulai operasi asinkron pada objek StreamSocket untuk terhubung ke tujuan jaringan jarak jauh yang ditentukan oleh nama host jarak jauh dan nama layanan jarak jauh.
ConnectAsync(HostName, String, SocketProtectionLevel)	Memulai operasi asinkron pada objek StreamSocket untuk terhubung ke tujuan jarak jauh yang ditentukan oleh nama host jarak jauh, nama layanan jarak jauh, dan SocketProtectionLevel.
ConnectAsync(HostName, String, SocketProtectionLevel, NetworkAdapter)	Memulai operasi asinkron pada objek StreamSocket pada adaptor jaringan lokal tertentu untuk terhubung ke tujuan jarak jauh yang ditentukan oleh nama host jarak jauh, nama layanan jarak jauh, dan SocketProtectionLevel.

ConnectAsync(EndpointPair)

Memulai operasi asinkron pada objek StreamSocket untuk menyambungkan ke tujuan jaringan jarak jauh yang ditentukan sebagai objek EndpointPair .

public:
 virtual IAsyncAction ^ ConnectAsync(EndpointPair ^ endpointPair) = ConnectAsync;

/// [Windows.Foundation.Metadata.Overload("ConnectWithEndpointPairAsync")]
IAsyncAction ConnectAsync(EndpointPair const& endpointPair);

[Windows.Foundation.Metadata.Overload("ConnectWithEndpointPairAsync")]
public IAsyncAction ConnectAsync(EndpointPair endpointPair);

function connectAsync(endpointPair)

Public Function ConnectAsync (endpointPair As EndpointPair) As IAsyncAction

Parameter

endpointPair

EndpointPair

Objek EndpointPair yang menentukan nama host atau alamat IP lokal, nama layanan lokal atau port TCP, nama host jarak jauh atau alamat IP jarak jauh, dan nama layanan jarak jauh atau port TCP jarak jauh untuk tujuan jaringan jarak jauh.

Mengembalikan

IAsyncAction

Operasi koneksi asinkron pada objek StreamSocket .

Atribut

OverloadAttribute

Persyaratan Windows

Kemampuan aplikasi

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Keterangan

Jika objek EndpointPair yang diteruskan dalam parameter endpointPair berisi null untuk properti LocalHostName , maka sistem akan menyediakan alamat IP lokal yang akan digunakan. Jika objek EndpointPair yang diteruskan dalam parameter endpointPair berisi string kosong untuk properti LocalServiceName , maka sistem akan menyediakan port TCP lokal yang akan digunakan.

Dalam aplikasi UWP, kelas StreamSocket mendukung koneksi ke titik akhir jarak jauh saat proksi diperlukan untuk menyelesaikan koneksi. Dukungan untuk proksi ini bersifat otomatis dan transparan untuk aplikasi. Menyambungkan melalui proksi tidak didukung ketika alamat host lokal ditentukan, sehingga properti LocalHostName yang diteruskan dalam parameter endpointPair harus null. Untuk informasi selengkapnya, lihat keterangan tentang Dukungan untuk proksi dalam referensi kelas StreamSocket .

Di aplikasi Windows Phone 8.x, kelas StreamSocket tidak menyediakan dukungan otomatis untuk proksi.

Lihat juga

• ConnectAsync(HostName, String)
• ConnectAsync(EndpointPair, SocketProtectionLevel)
• ConnectAsync(HostName, String, SocketProtectionLevel)
• ConnectAsync(HostName, String, SocketProtectionLevel, NetworkAdapter)
• EndpointPair
• Cara mengatur batas waktu pada operasi soket
• Cara mengatur batas waktu pada operasi soket

ConnectAsync(EndpointPair, SocketProtectionLevel)

Memulai operasi asinkron pada objek StreamSocket untuk terhubung ke tujuan jaringan jarak jauh yang ditentukan sebagai objek EndpointPair dan enumerasi SocketProtectionLevel . Metode ini tidak dapat dipanggil dari JavaScript.

public:
 virtual IAsyncAction ^ ConnectAsync(EndpointPair ^ endpointPair, SocketProtectionLevel protectionLevel) = ConnectAsync;

/// [Windows.Foundation.Metadata.Overload("ConnectWithEndpointPairAndProtectionLevelAsync")]
IAsyncAction ConnectAsync(EndpointPair const& endpointPair, SocketProtectionLevel const& protectionLevel);

[Windows.Foundation.Metadata.Overload("ConnectWithEndpointPairAndProtectionLevelAsync")]
public IAsyncAction ConnectAsync(EndpointPair endpointPair, SocketProtectionLevel protectionLevel);

function connectAsync(endpointPair, protectionLevel)

Public Function ConnectAsync (endpointPair As EndpointPair, protectionLevel As SocketProtectionLevel) As IAsyncAction

Parameter

endpointPair

EndpointPair

Objek EndpointPair yang menentukan nama host atau alamat IP lokal, nama layanan lokal atau port TCP, nama host jarak jauh atau alamat IP jarak jauh, dan nama layanan jarak jauh atau port TCP jarak jauh untuk tujuan jaringan jarak jauh.

protectionLevel

SocketProtectionLevel

Tingkat perlindungan yang mewakili integritas dan enkripsi untuk objek StreamSocket .

Mengembalikan

IAsyncAction

Operasi koneksi asinkron pada objek StreamSocket .

Atribut

OverloadAttribute

Persyaratan Windows

Kemampuan aplikasi

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Keterangan

Jika objek EndpointPair yang diteruskan dalam parameter endpointPair berisi null untuk properti LocalHostName , maka sistem akan menyediakan alamat IP lokal yang akan digunakan. Jika objek EndpointPair yang diteruskan dalam parameter endpointPair berisi string kosong untuk properti LocalServiceName , maka sistem akan menyediakan port TCP lokal yang akan digunakan.

Jika objek EndpointPair yang diteruskan dalam parameter endpointPair berisi null untuk properti LocalServiceName , maka kesalahan akan terjadi.

Metode [ConnectAsync(EndpointPair, SocketProtectionLevel) tidak diekspos dalam JavaScript. Metode ini tidak dapat dipanggil dari JavaScript karena memiliki jumlah argumen yang sama dengan metode ConnectAsync(HostName, String).

Aplikasi yang ditulis dalam JavaScript tidak dapat menghubungkan StreamSocket menggunakan EndpointPair menggunakan SSL secara langsung. Untuk menyambungkan EndpointPair menggunakan SSL, aplikasi JavaScript dapat menggunakan kode berikut sebagai gantinya.

var clientSocket = new Windows.Networking.Sockets.StreamSocket();
var remoteName = new Windows.Networking.HostName("www.contoso.com");
var myEndpointPair = EndpointPair();

// Set properties needed on the EndpointPair
// We only set remote properties and the localServiceName,
// But the localHostName could also be set

myEndpointPair.localServiceName = "12345";
myEndpointPair.remoteHostName = remoteName;
myEndpointPair.remoteServiceName = "http";

// First connect the socket without SSL
clientSocket.connectAsync(myEendpointPair>).then(function () {
    // Now upgrade the connection to SSL
    clientSocket.upgradeToSslAsync(SocketProtectionLevel.Ssl).then(function () {
        // now connected using SSL
    }
}   

Ketika parameter protectionLevel diatur ke nilai yang memerlukan SSL atau TLS, operasi koneksi soket mungkin tidak habis waktu jika titik akhir jarak jauh tidak mendukung SSL atau TLS. Ini dapat terjadi jika operasi koneksi awal berhasil tetapi titik akhir jarak jauh tidak menghentikan koneksi selama jabat tangan SSL. Untuk melindungi dari situasi ini, aplikasi harus mengatur batas waktu pada operasi koneksi saat meminta SSL/TLS dan membatalkan operasi jika batas waktu berakhir. Untuk informasi selengkapnya tentang mengatur batas waktu menggunakan JavaScript pada operasi soket, lihat Cara mengatur batas waktu pada operasi soket . Untuk informasi selengkapnya tentang mengatur batas waktu menggunakan VB, C#, atau C++ pada operasi soket, lihat Cara mengatur batas waktu pada operasi soket .

Dalam aplikasi UWP, kelas StreamSocket mendukung koneksi ke titik akhir jarak jauh saat proksi diperlukan untuk menyelesaikan koneksi. Dukungan untuk proksi ini bersifat otomatis dan transparan untuk aplikasi. Menyambungkan melalui proksi tidak didukung ketika alamat host lokal ditentukan, sehingga properti LocalHostName yang diteruskan dalam parameter endpointPair harus null. Untuk informasi selengkapnya, lihat keterangan tentang Dukungan untuk proksi dalam referensi kelas StreamSocket .

Di aplikasi Windows Phone 8.x, kelas StreamSocket tidak menyediakan dukungan otomatis untuk proksi.

Lihat juga

• ConnectAsync(EndpointPair)
• ConnectAsync(HostName, String)
• ConnectAsync(HostName, String, SocketProtectionLevel)
• ConnectAsync(HostName, String, SocketProtectionLevel, NetworkAdapter)
• EndpointPair
• SocketProtectionLevel
• Cara mengatur batas waktu pada operasi soket
• Cara mengatur batas waktu pada operasi soket

ConnectAsync(HostName, String)

Memulai operasi asinkron pada objek StreamSocket untuk terhubung ke tujuan jaringan jarak jauh yang ditentukan oleh nama host jarak jauh dan nama layanan jarak jauh.

public:
 virtual IAsyncAction ^ ConnectAsync(HostName ^ remoteHostName, Platform::String ^ remoteServiceName) = ConnectAsync;

/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("ConnectAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction ConnectAsync(HostName const& remoteHostName, winrt::hstring const& remoteServiceName);

[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("ConnectAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction ConnectAsync(HostName remoteHostName, string remoteServiceName);

function connectAsync(remoteHostName, remoteServiceName)

Public Function ConnectAsync (remoteHostName As HostName, remoteServiceName As String) As IAsyncAction

Parameter

remoteHostName

HostName

Nama host atau alamat IP tujuan jaringan jarak jauh. Untuk Bluetooth RFCOMM, ini adalah alamat MAC.

remoteServiceName

String

Platform::String

winrt::hstring

Nama layanan atau nomor port TCP dari tujuan jaringan jarak jauh. Untuk Bluetooth RFCOMM, ini adalah alamat Bluetooth.

Mengembalikan

IAsyncAction

Operasi koneksi asinkron pada objek StreamSocket .

Atribut

DefaultOverloadAttribute OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Kemampuan aplikasi

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Keterangan

Parameter remoteHostName dan remoteServiceName harus disediakan. Jika remoteHostName null atau remoteServiceName null atau string kosong, kesalahan akan terjadi.

Dalam aplikasi UWP, kelas StreamSocket mendukung koneksi ke titik akhir jarak jauh saat proksi diperlukan untuk menyelesaikan koneksi. Dukungan untuk proksi ini bersifat otomatis dan transparan untuk aplikasi. Untuk informasi selengkapnya, lihat keterangan tentang Dukungan untuk proksi dalam referensi kelas StreamSocket .

Di aplikasi Windows Phone 8.x, kelas StreamSocket tidak menyediakan dukungan otomatis untuk proksi.

Lihat juga

• ConnectAsync(EndpointPair)
• ConnectAsync(EndpointPair, SocketProtectionLevel)
• ConnectAsync(HostName, String, SocketProtectionLevel)
• ConnectAsync(HostName, String, SocketProtectionLevel, NetworkAdapter)
• HostName
• Cara mengatur batas waktu pada operasi soket
• Cara mengatur batas waktu pada operasi soket

ConnectAsync(HostName, String, SocketProtectionLevel)

Memulai operasi asinkron pada objek StreamSocket untuk terhubung ke tujuan jarak jauh yang ditentukan oleh nama host jarak jauh, nama layanan jarak jauh, dan SocketProtectionLevel.

public:
 virtual IAsyncAction ^ ConnectAsync(HostName ^ remoteHostName, Platform::String ^ remoteServiceName, SocketProtectionLevel protectionLevel) = ConnectAsync;

/// [Windows.Foundation.Metadata.Overload("ConnectWithProtectionLevelAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction ConnectAsync(HostName const& remoteHostName, winrt::hstring const& remoteServiceName, SocketProtectionLevel const& protectionLevel);

[Windows.Foundation.Metadata.Overload("ConnectWithProtectionLevelAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction ConnectAsync(HostName remoteHostName, string remoteServiceName, SocketProtectionLevel protectionLevel);

function connectAsync(remoteHostName, remoteServiceName, protectionLevel)

Public Function ConnectAsync (remoteHostName As HostName, remoteServiceName As String, protectionLevel As SocketProtectionLevel) As IAsyncAction

Parameter

remoteHostName

HostName

Nama host atau alamat IP tujuan jaringan jarak jauh. Untuk Bluetooth RFCOMM, ini adalah alamat MAC.

remoteServiceName

String

Platform::String

winrt::hstring

Nama layanan atau nomor port TCP dari tujuan jaringan jarak jauh. Untuk Bluetooth RFCOMM, ini adalah alamat Bluetooth.

protectionLevel

SocketProtectionLevel

Tingkat perlindungan yang mewakili integritas dan enkripsi untuk objek StreamSocket .

Mengembalikan

IAsyncAction

Operasi koneksi asinkron pada objek StreamSocket .

Atribut

OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Kemampuan aplikasi

ID_CAP_NETWORKING [Windows Phone] internetClientServer privateNetworkClientServer

Keterangan

Parameter remoteHostName dan remoteServiceName harus disediakan. Jika remoteHostName null atau remoteServiceName null atau string kosong, kesalahan akan terjadi.

Ketika parameter protectionLevel diatur ke nilai yang memerlukan SSL atau TLS, operasi koneksi soket mungkin tidak habis waktu jika tujuan jaringan jarak jauh tidak mendukung SSL atau TLS. Ini dapat terjadi jika operasi koneksi awal berhasil tetapi host jarak jauh tidak menghentikan koneksi selama jabat tangan SSL. Untuk melindungi dari situasi ini, aplikasi harus mengatur batas waktu pada operasi koneksi saat meminta SSL/TLS dan membatalkan operasi jika batas waktu berakhir. Untuk informasi selengkapnya tentang mengatur batas waktu menggunakan JavaScript pada operasi soket, lihat Cara mengatur batas waktu pada operasi soket . Untuk informasi selengkapnya tentang mengatur batas waktu menggunakan VB, C#, atau C++ pada operasi soket, lihat Cara mengatur batas waktu pada operasi soket .

Dalam aplikasi UWP, kelas StreamSocket mendukung koneksi ke titik akhir jarak jauh saat proksi diperlukan untuk menyelesaikan koneksi. Dukungan untuk proksi ini bersifat otomatis dan transparan untuk aplikasi. Untuk informasi selengkapnya, lihat keterangan tentang Dukungan untuk proksi dalam referensi kelas StreamSocket .

Di aplikasi Windows Phone 8.x, kelas StreamSocket tidak menyediakan dukungan otomatis untuk proksi.

Lihat juga

• ConnectAsync(EndpointPair)
• ConnectAsync(HostName, String)
• ConnectAsync(EndpointPair, SocketProtectionLevel)
• ConnectAsync(HostName, String, SocketProtectionLevel, NetworkAdapter)
• HostName
• SocketProtectionLevel
• Cara mengatur batas waktu pada operasi soket
• Cara mengatur batas waktu pada operasi soket

ConnectAsync(HostName, String, SocketProtectionLevel, NetworkAdapter)

Memulai operasi asinkron pada objek StreamSocket pada adaptor jaringan lokal tertentu untuk menyambungkan ke tujuan jarak jauh yang ditentukan oleh nama host jarak jauh, nama layanan jarak jauh, dan SocketProtectionLevel.

public:
 virtual IAsyncAction ^ ConnectAsync(HostName ^ remoteHostName, Platform::String ^ remoteServiceName, SocketProtectionLevel protectionLevel, NetworkAdapter ^ adapter) = ConnectAsync;

/// [Windows.Foundation.Metadata.Overload("ConnectWithProtectionLevelAndAdapterAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction ConnectAsync(HostName const& remoteHostName, winrt::hstring const& remoteServiceName, SocketProtectionLevel const& protectionLevel, NetworkAdapter const& adapter);

[Windows.Foundation.Metadata.Overload("ConnectWithProtectionLevelAndAdapterAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction ConnectAsync(HostName remoteHostName, string remoteServiceName, SocketProtectionLevel protectionLevel, NetworkAdapter adapter);

function connectAsync(remoteHostName, remoteServiceName, protectionLevel, adapter)

Public Function ConnectAsync (remoteHostName As HostName, remoteServiceName As String, protectionLevel As SocketProtectionLevel, adapter As NetworkAdapter) As IAsyncAction

Parameter

remoteHostName

HostName

Nama host atau alamat IP tujuan jaringan jarak jauh. Untuk Bluetooth RFCOMM, ini adalah alamat MAC.

remoteServiceName

String

Platform::String

winrt::hstring

Nama layanan atau nomor port TCP dari tujuan jaringan jarak jauh. Untuk Bluetooth RFCOMM, ini adalah alamat Bluetooth.

protectionLevel

SocketProtectionLevel

Tingkat perlindungan yang mewakili integritas dan enkripsi untuk objek StreamSocket .

adapter

NetworkAdapter

Adaptor jaringan lokal yang digunakan untuk operasi sambungkan pada objek StreamSocket .

Mengembalikan

IAsyncAction

Operasi koneksi asinkron pada objek StreamSocket .

Atribut

OverloadAttribute RemoteAsyncAttribute

Keterangan

Metode [ConnectAsync(Hostname, String, SocketProtectionLevel, NetworkAdapter) mengikat antarmuka jaringan yang ditentukan dalam parameter adaptor pada komputer lokal dan nama host jarak jauh dan nama layanan yang ditentukan dalam parameter remoteHostName dan remoteServiceName dengan tingkat perlindungan yang ditentukan dalam parameter protectionLevel .

Parameter remoteHostName dan remoteServiceName harus disediakan. Jika remoteHostNamenull atau remoteServiceNamenull atau string kosong, kesalahan akan terjadi. Jika parameter adapternull, kesalahan akan terjadi.

Mekanisme resolusi nama yang digunakan oleh metode [ConnectAsync(Hostname, String, SocketProtectionLevel, NetworkAdapter) terbatas pada antarmuka yang ditentukan untuk namespace layanan sistem nama domain (DNS).

Menggunakan adaptor jaringan yang ditentukan adalah berdasarkan upaya terbaik. Sistem dengan adaptor yang dikonfigurasi dalam mode weak-host atau penerusan dapat menggunakan adaptor selain adaptor yang ditentukan.

Ketika parameter protectionLevel diatur ke nilai yang memerlukan SSL atau TLS, operasi sambungkan soket mungkin tidak batas waktu jika tujuan jaringan jarak jauh tidak mendukung SSL atau TLS. Ini dapat terjadi jika operasi koneksi awal berhasil tetapi host jarak jauh tidak menghentikan koneksi selama jabat tangan SSL. Untuk melindungi dari situasi ini, aplikasi harus mengatur batas waktu pada operasi koneksi saat meminta SSL/TLS dan membatalkan operasi jika batas waktu berakhir. Untuk informasi selengkapnya tentang mengatur batas waktu menggunakan JavaScript pada operasi soket, lihat Cara mengatur batas waktu pada operasi soket . Untuk informasi selengkapnya tentang mengatur batas waktu menggunakan VB, C#, atau C++ pada operasi soket, lihat Cara mengatur batas waktu pada operasi soket .

Aplikasi dapat mengambil NetworkAdapter yang valid dengan memeriksa instans HostName (menggunakan metode NetworkInformation.GetHostNames , misalnya) dan mengambil objek IPInformation dari properti Hostname.IPInformation . Properti IPInformation.NetworkAdapter dapat digunakan untuk mengambil NetworkAdapter terkait.

Dalam aplikasi UWP, kelas StreamSocket mendukung koneksi ke titik akhir jarak jauh saat proksi diperlukan untuk menyelesaikan koneksi. Dukungan untuk proksi ini bersifat otomatis dan transparan terhadap aplikasi. Namun, menyambungkan melalui proksi tidak didukung ketika adaptor jaringan tertentu dipilih. Jadi dukungan proksi dinonaktifkan saat metode [ConnectAsync(HostName, String, SocketProtectionLevel, NetworkAdapter) digunakan. Untuk informasi selengkapnya, lihat keterangan tentang Dukungan untuk proksi dalam referensi kelas StreamSocket .

Di aplikasi Windows Phone 8.x, kelas StreamSocket tidak menyediakan dukungan otomatis untuk proksi.

Lihat juga

• ConnectAsync(EndpointPair)
• ConnectAsync(HostName, String)
• ConnectAsync(EndpointPair, SocketProtectionLevel)
• ConnectAsync(HostName, String, SocketProtectionLevel)
• IPInformation
• NetworkAdapter
• Cara mengatur batas waktu pada operasi soket
• Cara mengatur batas waktu pada operasi soket