Show All

# membership Element

Associates a user or group of users with a role.

## Type

`xsd:complexType`

## Child Elements

Element | Description
--- | ---
getUserNameFromData | Allows user names to be determined by an XPath query into the data in the main data source or a secondary data source and to be associated with a role.
userName | Defines a user to a particular role.
group | Defines which group a user belongs to.

## Attributes

None.

## Definition

    <xsd:element name="membership">
      <xsd:complexType>
        <xsd:choice minOccurs="1" maxOccurs="unbounded">
          <xsd:element ref="xsf:getUserNameFromData"/>
          <xsd:element ref="xsf:userName"/>
          <xsd:element ref="xsf:group"/>
        </xsd:choice>
      </xsd:complexType>
    </xsd:element>

## Remarks

InfoPath associates a role with the current user based on the membership order in the form definition file (.xsf). Developers can modify this order by hand in the form definition file. The membership element must be a child of the roles element.

Note This item is not supported when the Disable Service Pack features option on the Advanced tab of the Options dialog box in InfoPath is selected or when Microsoft Office 2003 Editions Service Pack 1 or later is not installed. Any form defined by a form definition file (.xsf) that includes this item cannot be opened in InfoPath when service pack features are disabled or unavailable.

## Example

The following is an example of the membership element:

    <xsf:roles initiator="A" default="C" hideStatusBarDisplay="yes">
       <xsf:role name="A"/>
       <xsf:role name="B"/>
       <xsf:role name="C"/>

       <xsf:membership>
          <xsf:getUserNameFromData dataObject="catalog" select="/dfs:myFields/dfs:dataFields/d:UserA" memberOf="B"/>
          <xsf:userName name="Domain\username1" memberOf="A"/>
          <xsf:userName name="Domain\username2" memberOf="B"/>
          <xsf:group name="Domain\username3" memberOf="C"/>
       </xsf:membership>
    </xsf:roles>

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp