EntityCollection.Create Method (String, Boolean)

Creates an Entity object.

Namespace:  Microsoft.Office.Server.ApplicationRegistry.Administration
Assembly:  Microsoft.SharePoint.Portal (in Microsoft.SharePoint.Portal.dll)

Syntax

'Declaration
Public Function Create ( _
    name As String, _
    isCached As Boolean _
) As Entity

'Usage
Dim instance As EntityCollection
Dim name As String
Dim isCached As Boolean
Dim returnValue As Entity

returnValue = instance.Create(name, isCached)

public Entity Create(
    string name,
    bool isCached
)

Parameters

• name
  Type: System.String
  The name of the entity.

• isCached
  Type: System.Boolean
  true if cached; otherwise, false.

Return Value

Type: Microsoft.Office.Server.ApplicationRegistry.Administration.Entity
An Entity object.

Examples

This example creates an entity called ProductModel from the AdventureWorks2000 database.

Prerequisites

• Ensure a Shared Service Provider has already been created.

• Create an LobSystem and set connection parameters as shown in How to: Create an LobSystem Using the Administration Object Model.

• Replace the constant value EnterYourSSPNameHere in the code with the name of your Shared Resource Provider.

• Project References

Add the following Project References in your console application code project before running this sample:

• Microsoft.SharePoint

• Microsoft.SharePoint.Portal

• Microsoft.Office.Server

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Office.Server.ApplicationRegistry.Administration;
using Microsoft.Office.Server.ApplicationRegistry.Infrastructure;
using WSSAdmin = Microsoft.SharePoint.Administration;
using OSSAdmin = Microsoft.Office.Server.Administration;

namespace Microsoft.SDK.SharePointServer.Samples
{
    class GetStartedAndCreateSystem
    {
        const string yourSSPName ="EnterYourSSPNameHere";

        static void Main(string[] args)
        {
            SetupBDC();
            CreateEntity();
            Console.WriteLine("Press any key to exit...");
            Console.Read();
        }
        static void SetupBDC()
        {
            SqlSessionProvider.Instance().SetSharedResourceProviderToUse(yourSSPName);
        }
        static void CreateEntity()
        {
            LobSystemInstance mySysInstance = null;
            LobSystemInstanceCollection sysInsCollection = ApplicationRegistry.Instance.GetLobSystemInstancesLikeName("AdventureWorksSampleFromCode");
            foreach (LobSystemInstance sysInstance in sysInsCollection)
            {
                if (sysInstance.Name == "AdventureWorksSampleFromCode")
                {
                    mySysInstance = sysInstance;
                    break;
                }
            }
            IList<Entity> entityCollection = new List<Entity>(mySysInstance.LobSystem.Entities);
            Entity newEntity = mySysInstance.LobSystem.Entities.Create("ProductModel", true);
            EntityCollection entityColl = mySysInstance.LobSystem.Entities;
            foreach (Entity entity in entityColl)
            {
                if (entity.Name == "ProductModel")
                {
                    entity.Identifiers.Create("ProductModelID", true, "System.Int32");
                    break;
                }
            }
            Console.WriteLine("Created the entity successfully.");
        }
    }
}

See Also

Reference

EntityCollection Class

EntityCollection Members

Create Overload

Microsoft.Office.Server.ApplicationRegistry.Administration Namespace