System.Security.Policy.UrlMembershipCondition Class

Assembly: Mscorlib.dll
Namespace: System.Security.Policy
Summary
Determines whether an assembly belongs to a code group by testing its URL. This class cannot be inherited.
C# Syntax:
[Serializable]
public sealed class UrlMembershipCondition : IMembershipCondition, ISecurityEncodable, ISecurityPolicyEncodable
Remarks
The complete URL is considered, including the protocol (HTTP, HTTPS, FTP) and the file. For example, http://www.fourthcoffee.com/process/grind.htm is a complete URL.

URLs can be matched exactly or by a wildcard in the final position. For example, http://www.fourthcoffee.com/process/* is a wildcard URL.

See also:
System.Security.Policy Namespace

System.Security.Policy.UrlMembershipCondition Member List:

Public Constructors
ctor #1 Initializes a new instance of the UrlMembershipCondition class with the URL that determines membership.
Public Properties
Url Read-write

Gets or sets the URL for which the membership condition tests.
Public Methods
Check Determines whether the specified evidence satisfies the membership condition.
Copy Creates an equivalent copy of the membership condition.
Equals Overridden:
Determines whether the URL from the specified object is equivalent to the URL contained in the current UrlMembershipCondition.
FromXml Overloaded:
FromXml(SecurityElement e)

Reconstructs a security object with a specified state from an XML encoding.
FromXml Overloaded:
FromXml(SecurityElement e, PolicyLevel level)

Reconstructs a security object with a specified state from an XML encoding.
GetHashCode Overridden:
Gets the hash code for the current membership condition.
GetType
(inherited from System.Object)
See base class member description: System.Object.GetType

Derived from System.Object, the primary base class for all objects.
ToString Overridden:
Creates and returns a string representation of the membership condition.
ToXml Overloaded:
ToXml()

Creates an XML encoding of the security object and its current state.
ToXml Overloaded:
ToXml(PolicyLevel level)

Creates an XML encoding of the security object and its current state with the specified PolicyLevel.
Protected Methods
Finalize
(inherited from System.Object)
See base class member description: System.Object.Finalize

Derived from System.Object, the primary base class for all objects.
MemberwiseClone
(inherited from System.Object)
See base class member description: System.Object.MemberwiseClone

Derived from System.Object, the primary base class for all objects.

Hierarchy:


System.Security.Policy.UrlMembershipCondition Member Details

ctor #1
Summary
Initializes a new instance of the UrlMembershipCondition class with the URL that determines membership.
C# Syntax:
public UrlMembershipCondition(
   string url
);
Parameters:

url

The URL for which to test.

Exceptions
Exception Type Condition
ArgumentNullException The url parameter is null.
Remarks
The complete URL is considered, including the protocol (HTTP, HTTPS, FTP) and the file, for example: http://www.fourthcoffee.com/process/grind.htm.

URLs can be matched exactly or by a wildcard in the final position, for example: http://www.fourthcoffee.com/process/*.

Return to top


Property: Url (read-write)
Summary
Gets or sets the URL for which the membership condition tests.
C# Syntax:
public string Url {get; set;}
Remarks
The complete URL is considered, including the protocol (HTTP, HTTPS, FTP) and the file. For example, http://www.fourthcoffee.com/process/grind.htm is a complete URL.

URLs can be matched exactly or by a wildcard in the final position. For example, http://www.fourthcoffee.com/process/* is a wildcard URL.

Return to top


Method: Check(
   Evidence evidence
)
Summary
Determines whether the specified evidence satisfies the membership condition.
C# Syntax:
public bool Check(
   Evidence evidence
);
Parameters:

evidence

The evidence set against which to make the test.

Return Value:
true if the specified evidence satisfies the membership condition; otherwise, false.
Implements:
IMembershipCondition.Check
Remarks
This membership condition tests only the Url evidence object.

Return to top


Method: Copy()
Summary
Creates an equivalent copy of the membership condition.
C# Syntax:
public IMembershipCondition Copy();
Return Value:
A new, identical copy of the current membership condition.
Implements:
IMembershipCondition.Copy

Return to top


Overridden Method: Equals(
   object o
)
Summary
Determines whether the URL from the specified object is equivalent to the URL contained in the current UrlMembershipCondition.
C# Syntax:
public override bool Equals(
   object o
);
Parameters:

o

The object to compare to the current UrlMembershipCondition.

Return Value:
true if the URL from the specified object is equivalent to the URL contained in the current UrlMembershipCondition; otherwise, false.
Implements:
IMembershipCondition.Equals

Return to top


Method: Finalize()
Inherited
See base class member description: System.Object.Finalize
C# Syntax:
~UrlMembershipCondition();

For more information on members inherited from System.Object click on the link above.

Return to top


Overloaded Method: FromXml(
   SecurityElement e
)
Summary
Reconstructs a security object with a specified state from an XML encoding.
C# Syntax:
public void FromXml(
   SecurityElement e
);
Parameters:

e

The XML encoding to use to reconstruct the security object.

Implements:
ISecurityEncodable.FromXml

Return to top


Overloaded Method: FromXml(
   SecurityElement e,
   PolicyLevel level
)
Summary
Reconstructs a security object with a specified state from an XML encoding.
C# Syntax:
public void FromXml(
   SecurityElement e,
   PolicyLevel level
);
Parameters:

e

The XML encoding to use to reconstruct the security object.

level

The policy level context, used to resolve named permission set references.

Exceptions
Exception Type Condition
ArgumentNullException The e parameter is null.
ArgumentException The e parameter is not a valid membership condition element.
Implements:
ISecurityPolicyEncodable.FromXml

Return to top


Overridden Method: GetHashCode()
Summary
Gets the hash code for the current membership condition.
C# Syntax:
public override int GetHashCode();
Return Value:
The hash code for the current membership condition.

Return to top


Method: GetType()
Inherited
See base class member description: System.Object.GetType
C# Syntax:
public Type GetType();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: MemberwiseClone()
Inherited
See base class member description: System.Object.MemberwiseClone
C# Syntax:
protected object MemberwiseClone();

For more information on members inherited from System.Object click on the link above.

Return to top


Overridden Method: ToString()
Summary
Creates and returns a string representation of the membership condition.
C# Syntax:
public override string ToString();
Return Value:
A string representation of the state of the membership condition.
Implements:
IMembershipCondition.ToString

Return to top


Overloaded Method: ToXml()
Summary
Creates an XML encoding of the security object and its current state.
C# Syntax:
public SecurityElement ToXml();
Return Value:
An XML encoding of the security object, including any state information.
Implements:
ISecurityEncodable.ToXml

Return to top


Overloaded Method: ToXml(
   PolicyLevel level
)
Summary
Creates an XML encoding of the security object and its current state with the specified PolicyLevel.
C# Syntax:
public SecurityElement ToXml(
   PolicyLevel level
);
Parameters:

level

The policy level context for resolving named permission set references.

Return Value:
An XML encoding of the security object, including any state information.
Implements:
ISecurityPolicyEncodable.ToXml

Return to top


Top of page

Copyright (c) 2002 Microsoft Corporation. All rights reserved.