MessageQueue.MachineName Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de naam op van de computer waar de Message Queuing-wachtrij zich bevindt.
public:
property System::String ^ MachineName { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Browsable(false)]
[System.Messaging.MessagingDescription("MQ_MachineName")]
public string MachineName { get; set; }[<System.ComponentModel.Browsable(false)>]
[<System.Messaging.MessagingDescription("MQ_MachineName")>]
member this.MachineName : string with get, setPublic Property MachineName As StringWaarde van eigenschap
De naam van de computer waar de wachtrij zich bevindt. De standaard message queuing is '.', de lokale computer.
- Kenmerken
Uitzonderingen
De MachineName is null.
– of –
De naam van de computer is ongeldig, mogelijk omdat de syntaxis onjuist is.
Er is een fout opgetreden bij het openen van een Message Queuing-methode.
Voorbeelden
In het volgende codevoorbeeld wordt de waarde van de eigenschap van een berichtenwachtrij MachineName opgehaald en ingesteld.
// Set the queue's MachineName property value to the name of the local
// computer.
queue.MachineName = ".";
// Display the new value of the queue's MachineName property.
Console.WriteLine("MessageQueue.MachineName: {0}", queue.MachineName);
Opmerkingen
Het MachineName is een integraal onderdeel van de beschrijvende naamsyntaxis van de wachtrij Path. In de volgende tabel ziet u de syntaxis die u moet gebruiken voor een wachtrij van een opgegeven type wanneer u het wachtrijpad wilt identificeren met behulp van de beschrijvende naam.
| Wachtrijtype | Syntaxis |
|---|---|
| Openbare wachtrij | MachineName\QueueName |
| Privéwachtrij | MachineName\Private$\QueueName |
| Logboekwachtrij | MachineName\QueueName\Journal$ |
| Logboekwachtrij van machine | MachineName\Journal$ |
| Wachtrij voor dead-letter van machine | MachineName\Deadletter$ |
| Wachtrij voor transactionele dead-letter van machine | MachineName\XactDeadletter$ |
Gebruik '.' voor de lokale computer bij het opgeven van de MachineName. Alleen de computernaam wordt herkend voor deze eigenschap, bijvoorbeeld Server0. De MachineName eigenschap biedt geen ondersteuning voor de INDELING van het IP-adres.
Als u de Path termen van de MachineNametoepassing definieert, genereert de toepassing een uitzondering bij het offline werken omdat de domeincontroller is vereist voor padvertaling. Daarom moet u de FormatName syntaxis voor de Path syntaxis gebruiken wanneer u offline werkt.
De MachineName, Pathen QueueName eigenschappen zijn gerelateerd. Als u de MachineName eigenschap wijzigt, wordt de Path eigenschap gewijzigd. Het is gebouwd op basis van de nieuwe MachineName en de QueueName. Als u bijvoorbeeld Path de syntaxis van de notatienaam wijzigt, worden de MachineName en QueueName eigenschappen opnieuw ingesteld om naar de nieuwe wachtrij te verwijzen. Als de QueueName eigenschap leeg is, wordt deze Path ingesteld op de logboekwachtrij van de computer die u opgeeft.
In de volgende tabel ziet u of deze eigenschap beschikbaar is in verschillende werkgroepmodi.
| Werkgroepmodus | Available |
|---|---|
| Lokale computer | Ja |
| Naam van lokale computer en directe indeling | Ja |
| Externe computer | Ja |
| Naam van externe computer en directe indeling | No |