Compartilhar via


Método Application.AddApplication

Adiciona ou modifica um definição de aplicativo corporação.

Espaço para nome Microsoft.SharePoint.Portal.SingleSignon
Conjunto de Módulos (Assembly) Microsoft.SharePoint.Portal.SingleSignon (em microsoft.sharepoint.portal.singlesignon.dll)

A sintaxe

<SingleSignonPermissionAttribute(SecurityAction.Demand, Access:=SingleSignonAccess.Minimal)> _
Public Shared Sub AddApplication ( _
    App As ApplicationInfo, _
    rgAppFields As ApplicationField(), _
    appcd As ApplicationCreationDisposition _
)

Dim App As ApplicationInfo
Dim rgAppFields As ApplicationField()
Dim appcd As ApplicationCreationDisposition

Application.AddApplication(App, rgAppFields, appcd)
[SingleSignonPermissionAttribute(SecurityAction.Demand, Access=SingleSignonAccess.Minimal)] 
public static void AddApplication (
    ApplicationInfo App,
    ApplicationField[] rgAppFields,
    ApplicationCreationDisposition appcd
)

Parâmetros

  • App
    Um objeto ApplicationInfo que especifica o definição de aplicativo corporação que é adicionado.
  • rgAppFields
    Um tipo de dados ApplicationField que contém os campos de uma definição de aplicativo corporação.O número máximo permitido ApplicationField dados tipos é cinco.Você deve especificar um at least tipo de dados ApplicationField ApplicationField.
  • appcd
    Um dos valores ApplicationCreationDisposition ApplicationCreationDisposition que especifica como a definição de aplicativo corporação é criada:

    • Se o definição de aplicativo corporação não existir, ela será criada independentemente ApplicationCreationDisposition.

    • Se o definição de aplicativo corporação existir e você especificar ApplicationCreationDisposition.Substituir e o tipo de dados ApplicationType ApplicationType é o mesmo, o definição de aplicativo corporação será substituído.

Comentários

Você pode get ou especificar credenciais somente após você adicionar o definição de aplicativo corporação para assinar o único - em banco de dados.Os usuários que são membros de assinar o único - na conta administrador ou a conta Gerenciador definição de aplicativo podem adicionar aplicativo definições.

O resultado da cada chamar para o AddApplication AddApplication método é auditado e armazenado em banco de dados de sign-on único.A enumeração ServiceAction ServiceAction registrada é AddApplication.

Exemplo

O seguinte mostra como usar o AddApplication método AddApplication exemplo de código.

using System;
using Microsoft.SharePoint.Portal.SingleSignon;

namespace SSOSampleCode
{
/// <summary>
/// Sample code for SharePoint Portal Single SignOn.
/// </summary>
class CMainEntry
{
            [STAThread]
            static void Main(string[] args)
            {
                try
                {
                    //Create the application fields (max 5 fields).
                    Application.ApplicationField[] rgFields = new Application.ApplicationField[5];

                    rgFields[0] = new Application.ApplicationField(
                        "Field1 Label",  //Application field name
                        true);           //true == mask in the UI, false == don't mask in the UI

                    rgFields[1] = new Application.ApplicationField(
                        "Field2 Label",
                        false);

                    rgFields[2] = new Application.ApplicationField(
                        "Field3 Label",
                        true);

                    rgFields[3] = new Application.ApplicationField(
                        "Field4 Label",
                        false);

                    rgFields[4] = new Application.ApplicationField(
                        "Field5 Label",
                        true);

                    //Create group application information data.
                    Application.ApplicationInfo App = new Application.ApplicationInfo(
                        "MyIndividualApplicationID",
                        "My Individual Applicaiton Display Name",
                        Application.ApplicationType.Individual,
                        "someone@someplace.someext");

                    //Now, add the application.
                    Application.AddApplication(
                        App,
                        rgFields,
                        Application.ApplicationCreationDisposition.CreateNew);

                    Console.WriteLine("Successfully added the individual application!");

                    //Get the application.
                    Application.ApplicationInfo MyApp = null;
                    Application.GetApplication(
                        "MyIndividualApplicationID",
                        ref MyApp);
                    Console.WriteLine("Application Information:");
                    Console.WriteLine("Application ID: " + MyApp.ApplicationName);
                    Console.WriteLine("Application friendly name: " + MyApp.ApplicationFriendlyName);
                    Console.WriteLine("Application contact: " + MyApp.ContactName);
                    Console.WriteLine("Application type: " + MyApp.Type);

                    //Now, delete the application.
                    Application.DeleteApplication("MyIndividualApplicationID");

                    Console.WriteLine("Successfully deleted the individual application!");
                }
                catch (SingleSignonException esso)
                {
                    Console.WriteLine("SingleSignonException caught.");
                    Console.WriteLine("Exception Code: " + "0x" + esso.LastErrorCode.ToString("x"));
                    Console.WriteLine("Source: " + esso.Source);
                    Console.WriteLine("StackTrace: " + esso.StackTrace);
                    Console.WriteLine("MethodName: " + esso.TargetSite.Name);
                    Console.WriteLine("Message: " + esso.Message);
                }
                catch (Exception e)
                {
                    Console.WriteLine("Exception caught.");
                    Console.WriteLine("Source: " + e.Source);
                    Console.WriteLine("StackTrace: " + e.StackTrace);
                    Console.WriteLine("MethodName: " + e.TargetSite.Name);
                    Console.WriteLine("Message: " + e.Message);
                }
            }
    }
}

Consulte também

Referência

Application De classe
Application Membros
Microsoft.SharePoint.Portal.SingleSignon De espaço para nome