AddLanguage Method
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.