The CardSpace Controls

CardSpaceButton Properties

The properties of the CardSpaceButton class are listed below. For a complete list of CardSpaceButton class members, see the CardSpaceButton Members topic.

Public Instance Properties

AccessKey (inherited from WebControl)Gets or sets the access key that allows you to quickly navigate to the Web server control.
AlternateText (inherited from CardSpaceControl) The alternate text displayed when the control image cannot be shown.
AppRelativeTemplateSourceDirectory (inherited from Control)Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.
Attributes (inherited from WebControl)Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.
BackColor (inherited from WebControl)Gets or sets the background color of the Web server control.
BindingContainer (inherited from Control)Gets the control that contains this control's data binding.
BorderColor (inherited from WebControl)Gets or sets the border color of the Web control.
BorderStyle (inherited from WebControl)Gets or sets the border style of the Web server control.
BorderWidth (inherited from WebControl)Gets or sets the border width of the Web server control.
ButtonImageType (inherited from CardSpaceControl) Provides for selection of one of the built in button images. Only applies if a user-specified image is not provided through the ButtonImageUrl property.
Claims (inherited from CardSpaceControl) Provides information on the claims which have been presented with an information card
ClientID (inherited from Control)Gets the server control identifier generated by ASP.NET.
Controls (inherited from CompositeControl)Gets a ControlCollection object that represents the child controls in a CompositeControl.
ControlStyle (inherited from WebControl)Gets the style of the Web server control. This property is used primarily by control developers.
ControlStyleCreated (inherited from WebControl)Gets a value indicating whether a Style object has been created for the ControlStyle property. This property is primarily used by control developers.
CssClass (inherited from WebControl)Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.
CssClassSupported (inherited from CardSpaceControl) Name of the css class for controls that should be shown only when information cards are supported. Set the CssClass property to this value for any controls that should be conditionally hidden or shown based on whether information cards are supported by the client browser.
CssClassUnsupported (inherited from CardSpaceControl) Name of the css class for controls that should be shown only when information cards are not supported. Set the CssClass property to this value for any controls that should be conditionally hidden or shown based on whether information cards are supported by the client browser.
Enabled (inherited from WebControl)Gets or sets a value indicating whether the Web server control is enabled.
EnableTheming (inherited from WebControl)Gets or sets a value indicating whether themes apply to this control.
EnableViewState (inherited from Control)Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.
Font (inherited from WebControl)Gets the font properties associated with the Web server control.
ForeColor (inherited from WebControl)Gets or sets the foreground color (typically the color of the text) of the Web server control.
HasAttributes (inherited from WebControl)Gets a value indicating whether the control has attributes set.
Height (inherited from WebControl)Gets or sets the height of the Web server control.
HiddenFieldName (inherited from CardSpaceControl) Name of the hidden field used to post back the selected card token. The default value is "{ClientID}_cardSpaceClaims" if this field is left blank.
HideIfUnsupported (inherited from CardSpaceControl) Defines whether the control is hidden if the browser does not support information cards.
ID (inherited from Control)Gets or sets the programmatic identifier assigned to the server control.
ImageUrl (inherited from CardSpaceControl) Used for entering the Url of an image that will be displayed as the button. When this property is specified, the ImageType property is ignored.
Issuer (inherited from CardSpaceControl) Used for overriding the issuer URI which defaults to "self", http://schemas.xmlsoap.org/ws/2005/05/identity/issuer/self
IssuerPolicy (inherited from CardSpaceControl) Used for setting an optional issuer policy URI
NamingContainer (inherited from Control)Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.
OnClientClick (inherited from CardSpaceControl) The client-side script that is executed on a client-side onclick.
Page (inherited from Control)Gets a reference to the Page instance that contains the server control.
Parent (inherited from Control)Gets a reference to the server control's parent control in the page control hierarchy.
PostBackUrl (inherited from CardSpaceControl) The Url to post to when the control is clicked.
PrivacyUrl (inherited from CardSpaceControl) Used for setting an optional privacy Url
PrivacyVersion (inherited from CardSpaceControl) Used for setting an optional privacy version
RequestAnonymous (inherited from CardSpaceControl) Determines whether the Anonymous property should be requested. Applies to Managed Cards.
RequestAuthentication (inherited from CardSpaceControl) Determines whether the Authentication property should be requested. Applies to Managed Cards.
RequestAuthorizationDecision (inherited from CardSpaceControl) Determines whether the Authorization Decision property should be requested. Applies to Managed Cards.
RequestCountry (inherited from CardSpaceControl) Determines whether the Country should be requeted URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/country According to RFC 2256: “This attribute contains a two-letter ISO 3166 country code.”
RequestDateOfBirth (inherited from CardSpaceControl) Determines whether the date of birth should be requested. URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/dateofbirth Definition: The date of birth of a subject in a form allowed by the xs:date data type.
RequestDenyOnlySid (inherited from CardSpaceControl) Determines whether the DenyOnlySid property should be requested. Applies to Managed Cards.
RequestDns (inherited from CardSpaceControl) Determines whether the DNS property should be requested. Applies to Managed Cards.
RequestedClaims (inherited from CardSpaceControl) A list of custom claims which should be requested in addition to those specified through properties.
RequestEmail (inherited from CardSpaceControl) 
RequestGender (inherited from CardSpaceControl) Determines whether the Gender (Male/Female) should be requested. URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/gender Gender of a subject that can have any of these exact string values – ‘0’ (meaning unspecified), ‘1’ (meaning Male) or ‘2’ (meaning Female). Using these values allows them to be language neutral.
RequestGivenName (inherited from CardSpaceControl) Defines whether the Given name (first name) should be requested. URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname Preferred name or first name of a subject. According to RFC 2256: “This attribute is used to hold the part of a person's name which is not their surname nor middle name.”
RequestHash (inherited from CardSpaceControl) Determines whether the Hash property should be requested. Applies to Managed Cards.
RequestHomePhone (inherited from CardSpaceControl) Determines whether the home (primary) telephone number should be requested. URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/homephone Primary or home telephone number of a subject. According to inetOrgPerson using RFC 1274: “This attribute type specifies a home telephone number associated with a person.” Attribute values should follow the agreed format for international telephone numbers, e.g. +44 81 123 4567 or 1 407 253-2266.
RequestLocality (inherited from CardSpaceControl) Defines whether the Locality (City) should be requested. URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/locality Locality component of a subject’s address information. According to RFC 2256: “This attribute contains the name of a locality, such as a city, county or other geographic region.” e.g. Orlando.
RequestMobilePhone (inherited from CardSpaceControl) Determines whether the mobile phone number should be requested URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/mobilephone According to inetOrgPerson using RFC 1274: “This attribute type specifies a mobile telephone number associated with a person.” Attribute values should follow the agreed format for international telephone numbers, e.g. +44 81 123 4567 or 1 407 253-2266.
RequestName (inherited from CardSpaceControl) Determines whether the Name property should be requested. Applies to Managed Cards.
RequestNameIdentifier (inherited from CardSpaceControl) Determines whether the Name Identifier property should be requested. Applies to Managed Cards.
RequestOtherPhone (inherited from CardSpaceControl) Determines whether the secondary/work telephone number should be requested URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/otherphone Secondary or work telephone number of a subject. According to X.500(2001): “This attribute type specifies an office/campus telephone number associated with a person.” Attribute values should follow the agreed format for international telephone numbers, e.g. +44 71 123 4567.
RequestPostalCode (inherited from CardSpaceControl) Determines whether the Postal Code (Zip Code) should be requested URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/postalcode Postal code or zip code component of a subject’s address information. According to X.500(2001): “The postal code attribute type specifies the postal code of the named object. If this attribute value is present, it will be part of the object's postal address - zip code in USA, postal code for other countries.”
RequestPPID (inherited from CardSpaceControl) Determines if Personal Private Identifier is requested. Required in order to calculate Site Specific ID. URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/country According to RFC 2256: “This attribute contains a two-letter ISO 3166 country code.”
RequestRsa (inherited from CardSpaceControl) Determines whether the RSA property should be requested. Applies to Managed Cards.
RequestSid (inherited from CardSpaceControl) Determines whether the SID property should be requested. Applies to Managed Cards.
RequestSpn (inherited from CardSpaceControl) Determines whether the SPN property should be requested. Applies to Managed Cards.
RequestStateOrProvince (inherited from CardSpaceControl) Determines whether the State or Province should be requested URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/stateorprovince Abbreviation for state or province name of a subject’s address information. According to RFC 2256: “This attribute contains the full name of a state or province. The values should be coordinated on a national level and if well-known shortcuts exist - like the two-letter state abbreviations in the US – these abbreviations are preferred over longer full names.” e.g. FL.
RequestStreetAddress (inherited from CardSpaceControl) Defines whether the street address should be requested. URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/streetaddress Street address component of a subject’s address information. According to RFC 2256: “This attribute contains the physical address of the object to which the entry corresponds, such as an address for package delivery.” Its content is arbitrary, but typically given as a PO Box number or apartment/house number followed by a street name, e.g. 123 Elm Street
RequestSurname (inherited from CardSpaceControl) Determines whether the Last Name should be requested URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname Surname or family name of a subject. According to RFC 2256: “This is the X.500 surname attribute which contains the family name of a person.”
RequestSystem (inherited from CardSpaceControl) Determines whether the System property should be requested. Applies to Managed Cards.
RequestThumbprint (inherited from CardSpaceControl) Determines whether the Thumbprint property should be requested. Applies to Managed Cards.
RequestUpn (inherited from CardSpaceControl) Determines whether the UPN property should be requested. Applies to Managed Cards.
RequestUri (inherited from CardSpaceControl) Determines whether the URI property should be requested. Applies to Managed Cards.
RequestWebpage (inherited from CardSpaceControl) Determines whether a user's web page address should be requested. URI: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/webpage The Web page of a subject expressed as a URL.
RequestX500DistinguishedName (inherited from CardSpaceControl) Determines whether the X500 Distinguished Name property should be requested. Applies to Managed Cards.
Site (inherited from Control)Gets information about the container that hosts the current control when rendered on a design surface.
SkinID (inherited from WebControl)Gets or sets the skin to apply to the control.
Style (inherited from WebControl)Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.
TabIndex (inherited from WebControl)Gets or sets the tab index of the Web server control.
TemplateControl (inherited from Control)Gets or sets a reference to the template that contains this control.
TemplateSourceDirectory (inherited from Control)Gets the virtual directory of the Page or UserControl that contains the current server control.
Text The text displayed on the button.
TokenType (inherited from CardSpaceControl) Used for overriding the token type which defaults to urn:oasis:names:tc:SAML:1.0:assertion.
ToolTip (inherited from WebControl)Gets or sets the text displayed when the mouse pointer hovers over the Web server control.
UniqueID (inherited from Control)Gets the unique, hierarchically qualified identifier for the server control.
Visible (inherited from Control)Gets or sets a value that indicates whether a server control is rendered as UI on the page.
Width (inherited from WebControl)Gets or sets the width of the Web server control.

Protected Instance Properties

Adapter (inherited from Control)Gets the browser-specific adapter for the control.
ChildControlsCreated (inherited from Control)Gets a value that indicates whether the server control's child controls have been created.
ClientIDSeparator (inherited from Control)Gets a character value representing the separator character used in the ClientID property.
Events (inherited from Control)Gets a list of event handler delegates for the control. This property is read-only.
HasChildViewState (inherited from Control)Gets a value indicating whether the current server control's child controls have any saved view-state settings.
IdSeparator (inherited from Control)Gets the character used to separate control identifiers.
IsTrackingViewState (inherited from Control)Gets a value that indicates whether the server control is saving changes to its view state.
LoadViewStateByID (inherited from Control)Gets a value indicating whether the control participates in loading its view state by ID instead of index.
TagKey (inherited from WebControl)Gets the HtmlTextWriterTag value that corresponds to this Web server control. This property is used primarily by control developers.
TagName (inherited from WebControl)Gets the name of the control tag. This property is used primarily by control developers.
ViewState (inherited from Control)Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.
ViewStateIgnoresCase (inherited from Control)Gets a value that indicates whether the StateBag object is case-insensitive.

Protected Internal Instance Properties

Context (inherited from Control)Gets the HttpContext object associated with the server control for the current Web request.
DesignMode (inherited from Control)Gets a value indicating whether a control is being used on a design surface.
IsChildControlStateCleared (inherited from Control)Gets a value indicating whether controls contained within this control have control state.
IsEnabled (inherited from WebControl)Gets a value indicating whether the control is enabled.
IsViewStateEnabled (inherited from Control)Gets a value indicating whether view state is enabled for this control.

See Also

CardSpaceButton Class | QualityData.Web.UI.WebControls Namespace