Evidence.AddHost Method (System.Security.Policy)

AddHost Method

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Evidence..::.AddHost Method

Adds the specified evidence supplied by the host to the evidence set.

Namespace: System.Security.Policy
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic (Declaration)

Public Sub AddHost ( _
    id As Object _
)

Visual Basic (Usage)

Dim instance As Evidence
Dim id As Object

instance.AddHost(id)

public void AddHost(
    Object id
)

Visual C++

public:
void AddHost(
    Object^ id
)

JScript

public function AddHost(
    id : Object
)

Parameters

id: Type: System..::.Object
Any evidence object.

Exceptions

Exception	Condition
SecurityException	Locked is true and the code that calls this method does not have SecurityPermissionFlag..::.ControlEvidence.

Remarks

Use this method for evidence supplied by the host.

Note:
This method does not perform a check to prevent adding duplicate types of evidence. Many host evidence objects can exist at the same time.

Examples

The following code example shows the use of the AddHost method. This example is part of a larger example provided for the Evidence class.

Visual Basic

Dim url As New Url("http://www.treyresearch.com")
Console.WriteLine(("Adding host evidence " & url.ToString()))
ev2a.AddHost(url)
Dim ev2b As New Evidence(ev2a)
Console.WriteLine("Copy evidence into new evidence")
Dim enum1 As IEnumerator = ev2b.GetHostEnumerator()
enum1.MoveNext()
Console.WriteLine(enum1.Current.ToString())

Url url = new Url("http://www.treyresearch.com");
Console.WriteLine("Adding host evidence " + url.ToString());
ev2a.AddHost(url);
Evidence ev2b = new Evidence(ev2a);
Console.WriteLine("Copy evidence into new evidence");
IEnumerator enum1 = ev2b.GetHostEnumerator();
enum1.MoveNext();
Console.WriteLine(enum1.Current.ToString());

Visual C++

Url^ url = gcnew Url( "http://www.treyresearch.com" );
Console::WriteLine( "Adding host evidence {0}", url );
ev2a->AddHost( url );
Evidence^ ev2b = gcnew Evidence( ev2a );
Console::WriteLine( "Copy evidence into new evidence" );
IEnumerator^ enum1 = ev2b->GetHostEnumerator();
enum1->MoveNext();
Console::WriteLine( enum1->Current );

.NET Framework Security

SecurityPermission
for the ability to manipulate evidence when Locked is true. Associated enumeration: SecurityPermissionFlag..::.ControlEvidence

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference

Evidence Class

Evidence Members

System.Security.Policy Namespace