Semaphore.TryOpenExisting Metode

Definisi

Ruang nama:

System.Threading

Rakitan:

System.Threading.dll

Membuka semaphore bernama tertentu, jika sudah ada, dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.

Overload

TryOpenExisting(String, Semaphore)

Membuka semaphore bernama yang ditentukan, jika sudah ada, dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.

TryOpenExisting(String, Semaphore)

Sumber:

Semaphore.cs

Membuka semaphore bernama yang ditentukan, jika sudah ada, dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.

public:
 static bool TryOpenExisting(System::String ^ name, [Runtime::InteropServices::Out] System::Threading::Semaphore ^ % result);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static bool TryOpenExisting (string name, out System.Threading.Semaphore? result);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member TryOpenExisting : string * Semaphore -> bool

Public Shared Function TryOpenExisting (name As String, ByRef result As Semaphore) As Boolean

Parameter

name

String

Nama objek sinkronisasi yang akan dibagikan dengan proses lain. Namanya peka huruf besar/kecil. Karakter garis miring terbalik (\) dicadangkan dan hanya dapat digunakan untuk menentukan namespace layanan. Untuk informasi selengkapnya tentang namespace layanan, lihat bagian keterangan. Mungkin ada pembatasan lebih lanjut pada nama tergantung pada sistem operasi. Misalnya, pada sistem operasi berbasis Unix, nama setelah mengecualikan namespace harus berupa nama file yang valid.

result

Semaphore

Ketika metode ini kembali, berisi Semaphore objek yang mewakili semaphore bernama jika panggilan berhasil, atau null jika panggilan gagal. Parameter ini diperlakukan sebagai tidak diinisialisasi.

Mengembalikan

Boolean

true jika semaphore bernama berhasil dibuka; jika tidak, false. Dalam beberapa kasus, false dapat dikembalikan untuk nama yang tidak valid.

Atribut

SupportedOSPlatformAttribute

Pengecualian

ArgumentException

name adalah string kosong.

-atau-

Hanya .NET Framework: name lebih panjang dari MAX_PATH (260 karakter).

ArgumentNullException

nameadalah null.

IOException

name tidak valid. Ini bisa karena berbagai alasan, termasuk beberapa batasan yang mungkin ditempatkan oleh sistem operasi, seperti awalan yang tidak diketahui atau karakter yang tidak valid. Perhatikan bahwa nama dan awalan umum "Global\" dan "Local\" peka huruf besar/kecil. Untuk beberapa nama yang tidak valid, metode dapat kembali false sebagai gantinya.

-atau-

Ada beberapa kesalahan lainnya. Properti HResult dapat memberikan informasi lebih lanjut.

PathTooLongException

Terlalu name panjang. Pembatasan panjang dapat bergantung pada sistem operasi atau konfigurasi.

UnauthorizedAccessException

Semaphore bernama ada, tetapi pengguna tidak memiliki akses keamanan yang diperlukan untuk menggunakannya.

Keterangan

name mungkin diawali dengan Global\ atau Local\ untuk menentukan namespace. Global Ketika namespace ditentukan, objek sinkronisasi dapat dibagikan dengan proses apa pun pada sistem. Local Ketika namespace ditentukan, yang juga merupakan default ketika tidak ada namespace yang ditentukan, objek sinkronisasi dapat dibagikan dengan proses dalam sesi yang sama. Di Windows, sesi adalah sesi masuk, dan layanan biasanya berjalan dalam sesi non-interaktif yang berbeda. Pada sistem operasi seperti Unix, setiap shell memiliki sesinya sendiri. Objek sinkronisasi sesi-lokal mungkin sesuai untuk menyinkronkan antara proses dengan hubungan induk/anak di mana semuanya berjalan dalam sesi yang sama. Untuk informasi selengkapnya tentang nama objek sinkronisasi di Windows, lihat Nama Objek.

Jika objek sinkronisasi dari jenis yang diminta ada di namespace layanan, objek sinkronisasi yang ada akan dibuka. Jika objek sinkronisasi tidak ada di namespace, atau objek sinkronisasi dari jenis yang berbeda ada di namespace layanan, false dikembalikan.

Untuk membuat semaphore sistem ketika belum ada, gunakan salah Semaphore satu konstruktor yang memiliki name parameter .

Jika Anda tidak yakin apakah ada semaphore bernama, gunakan metode ini kelebihan beban alih-alih OpenExisting(String) metode kelebihan beban, yang melemparkan pengecualian jika semaphore tidak ada.

Kelebihan beban metode ini setara dengan memanggil TryOpenExisting metode kelebihan beban dan menentukan SemaphoreRights.SynchronizeSemaphoreRights.Modify hak, dikombinasikan dengan menggunakan operasi OR bitwise. Menentukan SemaphoreRights.Synchronize bendera memungkinkan utas untuk memasukkan semaphore, dan menentukan SemaphoreRights.Modify bendera memungkinkan utas untuk memanggil Release metode .