MessageQueue.Exists(String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Avgör om en Message Queuing-kö finns på den angivna sökvägen.
public:
static bool Exists(System::String ^ path);
public static bool Exists(string path);
static member Exists : string -> bool
Public Shared Function Exists (path As String) As Boolean
Parametrar
- path
- String
Platsen för kön som ska hittas.
Returer
trueom det finns en kö med den angivna sökvägen. annars . false
Undantag
Syntaxen path är ogiltig.
Ett fel uppstod vid åtkomst till en Message Queuing-metod.
-eller-
Metoden Exists(String) anropas i en privat fjärrkö
Programmet använde formatnamnssyntaxen när kön skulle verifieras.
Exempel
I följande kodexempel verifieras om det finns en Message Queuing-kö och tar sedan bort den.
#using <system.dll>
#using <system.messaging.dll>
using namespace System;
using namespace System::Messaging;
int main()
{
// Determine whether the queue exists.
if ( MessageQueue::Exists( ".\\myQueue" ) )
{
try
{
// Delete the queue.
MessageQueue::Delete( ".\\myQueue" );
}
catch ( MessageQueueException^ e )
{
if ( e->MessageQueueErrorCode == MessageQueueErrorCode::AccessDenied )
{
Console::WriteLine( "Access is denied. Queue might be a system queue." );
}
// Handle other sources of MessageQueueException.
}
}
return 0;
}
using System;
using System.Messaging;
namespace MyProject
{
/// <summary>
/// Provides a container class for the example.
/// </summary>
public class MyNewQueue
{
//**************************************************
// Provides an entry point into the application.
//
// This example verifies existence and attempts to
// delete a queue.
//**************************************************
public static void Main()
{
// Determine whether the queue exists.
if (MessageQueue.Exists(".\\myQueue"))
{
try
{
// Delete the queue.
MessageQueue.Delete(".\\myQueue");
}
catch(MessageQueueException e)
{
if(e.MessageQueueErrorCode ==
MessageQueueErrorCode.AccessDenied)
{
Console.WriteLine("Access is denied. " +
"Queue might be a system queue.");
}
// Handle other sources of MessageQueueException.
}
}
return;
}
}
}
Imports System.Messaging
Public Class MyNewQueue
' Provides an entry point into the application.
'
' This example verifies existence and attempts to
' delete a queue.
Public Shared Sub Main()
' Determine whether the queue exists.
If MessageQueue.Exists(".\myQueue") Then
Try
' Delete the queue.
MessageQueue.Delete(".\myQueue")
Catch e As MessageQueueException
If e.MessageQueueErrorCode = _
MessageQueueErrorCode.AccessDenied Then
Console.WriteLine("Access is denied. " _
+ "Queue might be a system queue.")
End If
' Handle other sources of exceptions as necessary.
End Try
End If
Return
End Sub
End Class
Kommentarer
Metoden Exists(String) avgör om en Message Queuing-kö finns på en angiven sökväg. Det finns ingen metod för att avgöra om det finns en kö med ett angivet formatnamn. Mer information om formatnamnssyntaxen och andra sökvägssyntaxformulär finns i Path egenskapen.)
Exists(String) är en dyr åtgärd. Använd den bara när det är nödvändigt i programmet.
Note
Metoden Exists(String) stöder inte prefixet FormatName .
Syntaxen för parametern path beror på vilken typ av kö som visas i följande tabell.
| Kötyp | Syntax |
|---|---|
| Offentlig kö | MachineName\QueueName |
Exists(String) kan inte anropas för att verifiera förekomsten av en fjärransluten privat kö.
Mer syntax finns i egenskapen Path .
Du kan också använda Label för att beskriva kösökvägen.
| Reference | Syntax |
|---|---|
| Label | Etikett:[ label ] |
I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.
| Arbetsgruppsläge | Tillgängligt |
|---|---|
| Lokal dator | Yes |
| Namn på lokal dator och direktformat | No |
| Fjärrdator | No |
| Namn på fjärrdator och direktformat | No |