RetrieveAvailableLanguages Message (CrmService)

banner art

[Applies to: Microsoft Dynamics CRM 4.0]

Find the latest SDK documentation: CRM 2015 SDK

Works for all deployment types Works online and offline

Retrieves the list of available language packs installed on the server.

The relevant classes are specified in the following table.

Type Class
Request RetrieveAvailableLanguagesRequest
Response RetrieveAvailableLanguagesResponse

Remarks

To use this message, pass an instance of the RetrieveAvailableLanguagesRequest class as the request parameter in the Execute method.

For a list of required privileges, see RetrieveAvailableLanguages Privileges.

Example

The following code example shows you how to use the RetrieveAvailableLanguages message.

[C#]
// Set up the CRM service.
CrmAuthenticationToken token = new CrmAuthenticationToken();
// You can use enums.cs from the SDK\Helpers folder to get the enumeration for Active Directory authentication.
token.AuthenticationType = 0; 
token.OrganizationName = "AdventureWorksCycle";
 
CrmService service = new CrmService();
service.Url = "http://<servername>:<port>/mscrmservices/2007/crmservice.asmx";
service.CrmAuthenticationTokenValue = token;
service.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Retrieve the Locale IDs from the server.
RetrieveAvailableLanguagesRequest request = new RetrieveAvailableLanguagesRequest();
RetrieveAvailableLanguagesResponse response = (RetrieveAvailableLanguagesResponse)Service.Execute(request);

// Create a CultureInfo array that represents the available languages.
System.Globalization.CultureInfo[] cultures =
    new System.Globalization.CultureInfo[response.LocaleIds.Length];

for (int i = 0; i < response.LocaleIds.Length; i++)
{
    cultures[i] = System.Globalization.CultureInfo.GetCultureInfo(response.LocaleIds[i]);
}

[Visual Basic .NET]
' Set up the CRM service.
Dim token As New CrmAuthenticationToken()
' You can use enums.cs from the SDK\Helpers folder to get the enumeration for Active Directory authentication.
token.AuthenticationType = 0
token.OrganizationName = "AdventureWorksCycle";
 
Dim service As New CrmService()
service.Url = "http://<servername>:<port>/mscrmservices/2007/crmservice.asmx";
service.CrmAuthenticationTokenValue = token;
service.Credentials = System.Net.CredentialCache.DefaultCredentials

' Retrieve the Locale IDs from the server.
Dim request As New RetrieveAvailableLanguagesRequest()
Dim response As RetrieveAvailableLanguagesResponse = CType(Service.Execute(request), RetrieveAvailableLanguagesResponse)

' Create a CultureInfo array that represents the available languages.
Dim cultures(response.LocaleIds.Length - 1) As System.Globalization.CultureInfo

For i As Integer = 0 To response.LocaleIds.Length - 1
   cultures(i) = System.Globalization.CultureInfo.GetCultureInfo(response.LocaleIds(i))
Next i

See Also

Concepts

Reference

© 2010 Microsoft Corporation. All rights reserved.