AddLanguage Method

Article
11/12/2009

Adds the given language to the current catalog.

Namespace: Microsoft.CommerceServer.Catalog
Assembly: Microsoft.CommerceServer.Catalog (in Microsoft.CommerceServer.Catalog.dll)

Syntax

'Declaration
Public Sub AddLanguage ( _
    languageToAdd As String _
)

'Usage
Dim instance As ProductCatalog
Dim languageToAdd As String

instance.AddLanguage(languageToAdd)

public void AddLanguage(
    string languageToAdd
)

public:
void AddLanguage(
    String^ languageToAdd
)

public function AddLanguage(
    languageToAdd : String
)

Parameters

languageToAdd
Type: System..::.String
The language to add.

Exceptions

Exception	Condition
ArgumentNullException	The languageToAdd is nullNothingnullptra null reference (Nothing in Visual Basic).
ValidationException	The languageToAdd is invalid.
EntityAlreadyExistsException	The languageToAdd already exists.

Remarks

This method will add the language to the current catalog. After you add a language you should call the Save method to save the changes to the catalog system. The languageToAdd should:

Not be nullNothingnullptra null reference (Nothing in Visual Basic) or blank.
Not exceed 10 characters.
Not contain the ,'[] characters.
Not already exist in the catalog.

After you add a language to the catalog a column named "DisplayName_languageToAdd" will be added to the Information dataset. You can set the display name for the catalog in this language by setting the display name on the newly added column.

Examples

internal void AddRemoveLanguages(string catalogName, string languagetoAdd, string languageToRemove)
{
  try
  {
    // Get the base catalog for the specified catalog name
    ProductCatalog productCatalog = catalogContext.GetCatalog(catalogName);
    // Call AddLanguage to add the language 
    // Call RemoveLanguage to remove the language
    productCatalog.AddLanguage(languagetoAdd);
    productCatalog.RemoveLanguage(languageToRemove);
    // Call Save to save the information to the catalog system
    productCatalog.Save();
  }
  catch (EntityAlreadyExistsException ex)
  {
    // The language already exists
    Console.WriteLine(ex.Message);
    throw;
  }
  catch (EntityDoesNotExistException ex)
  {
    // The language does not exist
    Console.WriteLine(ex.Message);
    throw;
  }
}

Permissions

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via