UserInclusionList.Add Method (2007 System)

Adds the specified AddInSecurityEntry object to the inclusion list.

Namespace:  Microsoft.VisualStudio.Tools.Office.Runtime.Security
Assembly:  Microsoft.VisualStudio.Tools.Office.Runtime.v9.0 (in Microsoft.VisualStudio.Tools.Office.Runtime.v9.0.dll)

Syntax

'Declaration
Public Shared Sub Add ( _
    securityEntry As AddInSecurityEntry _
)
'Usage
Dim securityEntry As AddInSecurityEntry 

UserInclusionList.Add(securityEntry)
public static void Add(
    AddInSecurityEntry securityEntry
)
public:
static void Add(
    AddInSecurityEntry^ securityEntry
)
public static function Add(
    securityEntry : AddInSecurityEntry
)

Parameters

Exceptions

Exception Condition
ArgumentNullException

The AddInSecurityEntry is null.

Remarks

If a URI is already in the inclusion list, the existing entry associated with that URI is always overwritten.

Examples

The following code example shows how to create an AddInSecurityEntry and add it to the UserInclusionList. This example requires an Imports (for Visual Basic) or using (for C#) statement for the Microsoft.VisualStudio.Tools.Office.Runtime.Security namespace at the top of your code file.

Dim publicKey As String = "<RSAKeyValue><Modulus>mUl8MhOil1fKLKYpHItsyCGNXxGJW74L8d4zOVwSvLDP1qoXF0lLqf/Ql8yO+31zuFbx8Aer3eQz9tcb/pz0NJREdbeOvxYa+nHTnR3j7rRUkmE8AKzvcG8BmTlgbprXaY0QTln8syHTC7yY5AA+xibwatFMpEpEBRqF5MmsGkE=</Modulus><Exponent>AQAB</Exponent></RSAKeyValue>" 
Dim solutionLocation As New _
    Uri("http://DeploymentServer/MySolution/MySolution.vsto")
Dim entry As AddInSecurityEntry

Try
    entry = New AddInSecurityEntry(solutionLocation, publicKey)
    UserInclusionList.Add(entry)

Catch e As ArgumentNullException
    Console.WriteLine(("Exception: " + e.Message))
End Try
string publicKey = "<RSAKeyValue><Modulus></Modulus><Exponent>AQAB</Exponent></RSAKeyValue>";
Uri solutionLocation = new Uri(@"http://DeploymentServer/MySolution/MySolution.vsto");

AddInSecurityEntry entry;

try
{
    entry = new AddInSecurityEntry(solutionLocation, publicKey);
    UserInclusionList.Add(entry);
}

catch (ArgumentNullException e)
{
    Console.WriteLine("Exception: " + e.Message);
}

.NET Framework Security

See Also

Reference

UserInclusionList Class

UserInclusionList Members

Microsoft.VisualStudio.Tools.Office.Runtime.Security Namespace