Plik konfiguracji WsdCodeGen

Plik konfiguracji WsdCodeGen jest zwykle generowany przez narzędzie WsdCodeGen. Pliki konfiguracji można tworzyć ręcznie, ale złożoność i długość pliku zwykle wyklucza kodowanie ręczne. Zdecydowanie zalecamy użycie narzędzia WsdCodeGen do wygenerowania pliku. Aby uzyskać więcej informacji na temat generowania plików konfiguracji, zobacz Using WsdCodeGen and WsdCodeGen Command Line Syntax.

Należy sprawdzić wygenerowany plik konfiguracji i w razie potrzeby zmodyfikować go przed użyciem go w celu utworzenia kodu źródłowego. Plik konfiguracji wygenerowany przez program WsdCodeGen jest zazwyczaj wystarczający dla większości programowania klientów.

Aby użyć pliku konfiguracji do programowania serwerów, wymagane są pewne modyfikacje. Jeśli hosting jest włączony (tj. wybrano tryb "wszystkie" lub "host"), zmodyfikuj zawartość elementu ThisModelMetadata i jego elementów podrzędnych w razie potrzeby. Ponadto zmodyfikuj lub usuń elementy PnPXDeviceCategory, PnPXHardwareIdoraz elementów PnPXCompatible Id wewnątrz elementu ThisModelMetadata lub elementów hosted w razie potrzeby.

Plik konfiguracji składa się z sekwencji elementów, które dostarczają dane wejściowe do generowania kodu, a następnie dowolną liczbę plików elementów, które opisują pliki do wygenerowania. Dane wejściowe zawierają kilka właściwości globalnych i odwołań do typów wyrażonych w zestawach WSDL, XSD i zarządzanych. Tekst i CDATA w pliku elementy są zapisywane w wygenerowanych plikach bez modyfikacji. Inne elementy w pliku elementy są zastępowane w wygenerowanych plikach przy użyciu wygenerowanego kodu.

Pliki konfiguracji XML muszą być zgodne z kilkoma ogólnymi regułami, aby można je było prawidłowo sformatować do użycia z narzędziem generatora kodu. Są to:

• Elementem głównym dowolnego pliku konfiguracji jest wsdCodeGen.

• Elementy zawierające proste typy danych są zamienne z atrybutami. Na przykład:

  <wsdCodeGen>
      <layerNumber>1</layerNumber>
  </wsdCodeGen>
  

  jest odpowiednikiem:

  <wsdCodeGen layerNumber="1"/>
  

• Ogólnie rzecz biorąc, nie ma żadnego ograniczenia w kolejności elementów. Na przykład:

  <wsdCodeGen>
      <layerNumber>1</layerNumber>
      <layerPrefix>MEDIA_</layerPrefix>
  </wsdCodeGen>
  

  jest odpowiednikiem:

  <wsdCodeGen>
      <layerPrefix>MEDIA_</layerPrefix>
      <layerNumber>1</layerNumber>
  </wsdCodeGen>
  

  Jednak generator kodu przetwarza plik konfiguracji w jednym przebiegu, a kolejność ma pewne znaczenie. Na przykład plik elementów, które generują kod odnoszący się do określonego typu portu, muszą wystąpić po elemecie, który instruuje generator kodu, aby odczytać kontrakt typu portu.

Aby uzyskać pełną listę elementów używanych w plikach konfiguracji WsdCodeGen, zobacz WsdCodeGen Configuration File XML Reference.

Przykładowe pliki konfiguracji są dołączone do zestawu Windows SDK. Aby uzyskać więcej informacji, zobacz przykłady WSDAPI.

Tematy pokrewne

About WsdCodeGen

przykłady WSDAPI