WS_FIELD_DESCRIPTION結構 (webservices.h)

表示結構中欄位的串行化資訊。

語法

typedef struct _WS_FIELD_DESCRIPTION {
  WS_FIELD_MAPPING mapping;
  WS_XML_STRING    *localName;
  WS_XML_STRING    *ns;
  WS_TYPE          type;
  void             *typeDescription;
  ULONG            offset;
  ULONG            options;
  WS_DEFAULT_VALUE *defaultValue;
  ULONG            countOffset;
  WS_XML_STRING    *itemLocalName;
  WS_XML_STRING    *itemNs;
  WS_ITEM_RANGE    *itemRange;
} WS_FIELD_DESCRIPTION;

成員

mapping

識別欄位對應至 XML 的方式。 如需可在 XML 內容中公開字段的方式，請參閱 WS_FIELD_MAPPING 。

localName

要用於欄位的 XML 區域名稱。

此欄位是必要的，但下列情況可能為 NULL。 如果對應欄位 是WS_REPEATING_ELEMENT_FIELD_MAPPING，則這會識別為陣列專案專案的父元素之 「wrapper」 元素的區域名稱。 將此欄位設定為 (，且 ns 欄位) 為 NULL 將會省略包裝函式專案。 ns 和localName字段必須同時指定或同時指定為 NULL。

ns

要用於欄位的 XML 命名空間。

此欄位是必要的，但下列情況可能為 NULL。 如果對應欄位 是WS_REPEATING_ELEMENT_FIELD_MAPPING，則這會識別 「wrapper」 元素的命名空間，該元素是陣列專案專案的父元素。 將此欄位設定 (，且localName欄位) 為 NULL 將會省略包裝函式元素。 ns 和localName字段必須同時指定或同時指定為 NULL。

type

欄位的型別。 如需支援的類型清單 ，請參閱WS_TYPE 。

typeDescription

類型的其他資訊。 每個類型都有不同的描述結構。 視WS_TYPE而定，這可能是 NULL。

offset

包含結構內欄位的位移。

options

欄位的其他旗標。 如需旗標清單 ，請參閱WS_FIELD_OPTIONS 。 如果不需要任何旗標，這可能是 0。

defaultValue

指向欄位的預設值。 這用於下列實例：

• 已指定WS_FIELD_OPTIONAL ，且 XML 未包含 值。
• 已指定WS_NO_FIELD_MAPPING。

如果 defaultValue 是 NULL，則它與具有所有零的預設值相同。

countOffset

ULONG 欄位的結構位移，代表陣列中的項目數。

使用 WS_REPEATING_ELEMENT_FIELD_MAPPING 或數位類型時會使用此欄位， (WS_CHAR_ARRAY_TYPE、 WS_UTF8_ARRAY_TYPE WS_BYTE_ARRAY_TYPE ) 。
在其他情況下，不需要指定 (可以是 0) 。

itemLocalName

使用 WS_REPEATING_ELEMENT_FIELD_MAPPING 時，要用於重複專案的 XML 區域名稱。

在其他情況下，不需要指定此字段， (可以是 NULL) 。

itemNs

使用 WS_REPEATING_ELEMENT_FIELD_MAPPING 時，要用於重複專案的 XML 命名空間。

在其他情況下，不需要指定此字段， (可以是 NULL) 。

itemRange

使用 WS_REPEATING_ELEMENT_FIELD_MAPPING、 WS_REPEATING_ELEMENT_CHOICE_FIELD_MAPPING或 WS_REPEATING_ANY_ELEMENT_FIELD_MAPPING時，可能會出現的重複元素數目下限和上限。 如果未指定 (NULL) ，最小值為 0，最大值為 MAX ULONG。

在其他情況下，不需要指定此字段， (可以是 NULL) 。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
標頭	webservices.h