ExternalTypeReference Element (ProxyGen)

Article
11/16/2012

Describes a type that is not defined in the proxy descriptor file. The type can be an array.

<ExternalTypeReference arrayInfo = "Signature of the array"
    isInterface = "true/false"
    isMarshalByRefObject = "true/false"
    type = "Fully qualified type name">
</ExternalTypeReference>

ArrayExternalTypeReference_Type

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
arrayInfo	Optional array_Type attribute. A regular expression that specifies a combination of brackets and commas that represents the array signature, if the type is an array. The signature describes the number of dimensions, and the number of sub-arrays if the array is a jagged array. The following examples demonstrate usage of this attribute: [] specifies a one-dimensional array. [,] specifies a two-dimensional array. [][] specifies a jagged array, consisting of an array of arrays.
isInterface	Optional xs:boolean attribute. true if the type is an interface; otherwise, false. The default is true.
isMarshalByRefObject	Optional xs:boolean attribute. true if the type derives from MarshalByRefObject; otherwise, false. The default is false.
type	Required name_Type attribute. The fully qualified name of the type.

Child Elements

None.

Parent Elements

Element	Description
ReturnType	Represents the type of the return value of a method.
Type	Represents a reference to a type that is used in the declaration of a member or parameter.

Example

The following example demonstrates an ExternalTypeReference element that describes the type of a parameter of a method named Load. The parameter is an array of Byte objects.

<Method originalName="Load" isExcluded="false">
  <Parameter originalName="savedState">
    <Type>
      <ExternalTypeReference isInterface="false" type="System.Byte" arrayInfo="[]" />
    </Type>
  </Parameter>
  <ReturnType>
    <TypeReference type="Microsoft.VisualStudio.Tools.Applications.Samples.ShapeApp.IShape" />
  </ReturnType>
</Method>

Element Information

Namespace	https://schemas.microsoft.com/vsta/2008/01/ProxyGenDescriptor
Schema name	ProxyGen Descriptor
Validation file	ProxyGenDescriptorv2.xsd
Can be empty	Not applicable