Cómo: localizar códigoHow to: Localize code

El código sin localizar usa valores de cadena codificados de forma rígida.Unlocalized code uses hard-coded string values. Para localizar cadenas de código, sustitúyalas por llamadas a GetGlobalResourceObject, que es un método que hace referencia a los recursos localizados.To localize code strings, replace them with calls to GetGlobalResourceObject, which is a method that references localized resources.

Localizar códigoLocalize code

Para localizar el códigoTo localize code

  1. En el Explorador de soluciones, abra el menú contextual de un elemento de proyecto y, a continuación, elija agregar > módulo.In Solution Explorer, open the shortcut menu for a project item, and then choose Add > Module.

    Elija la archivo de recursos plantilla.Choose the Resources File template.

    Note

    Asegúrese de agregar el archivo de recursos a un elemento de proyecto de SharePoint para que esté disponible la propiedad Tipo de implementación.Be sure to add the resource file to a SharePoint project item so that the Deployment Type property is available. Esta propiedad es necesaria más adelante en este procedimiento.This property is required later in this procedure.

  2. Asigne el archivo de recursos de idioma predeterminado un nombre de su elección y anéxelo con un .resx extensión, como MyAppResources.resx.Give the default language resource file a name of your choice appended with a .resx extension, such as MyAppResources.resx.

  3. Repita los pasos 1 y 2 para agregar archivos de recursos independientes al elemento de proyecto de SharePoint: uno para cada idioma localizado.Repeat steps 1 and 2 to add separate resource files to the SharePoint project item: one for each localized language.

    Use el mismo nombre base para cada archivo de recursos localizado, pero agregue el identificador de la referencia cultural.Use the same base name for each localized resource file, but add the culture ID. Por ejemplo, de recursos localizado en alemán nombre MyAppResources.de-DE.resx.For example, name a German localized resource MyAppResources.de-DE.resx.

  4. Abra cada uno de los archivos de recursos y agregue las cadenas localizadas.Open each resource file and add localized strings. Use los mismos identificadores de cadena en cada archivo.Use the same string IDs in each file.

  5. Cambie el valor de la tipo de implementación propiedad de cada archivo de recursos para AppGlobalResource para hacer que cada archivo implementar en la carpeta App_GlobalResources del servidor.Change the value of the Deployment Type property of each resource file to AppGlobalResource to cause each file to deploy to the server's App_GlobalResources folder.

  6. Deje el valor de la acción de compilación propiedad de cada archivo como recurso incrustado.Leave the value of the Build Action property of each file as Embedded Resource.

    Los recursos incrustados se compilan en el archivo DLL del proyecto.Embedded resources are compiled into the project's DLL.

  7. Compile el proyecto para crear los archivos DLL satélite de recursos.Build the project to create the resource satellite DLLs.

  8. En el Diseñador de paquetes, elija el avanzadas pestaña y, a continuación, agregue el ensamblado satélite.In the Package Designer, choose the Advanced tab, and then add the satellite assembly.

  9. En el ubicación cuadro, anteponga una carpeta de Id. de referencia cultural a la ruta de acceso de ubicación, como de\<el nombre del elemento de proyecto >. resources.dll.In the Location box, prepend a culture ID folder to the Location path, such as de-DE\<Project Item Name>.resources.dll.

  10. Si la solución aún no hace referencia el ensamblado System.Web, agregue una referencia y una directiva del código al espacio de nombres System.Web.If your solution does not already reference the System.Web assembly, add a reference to it, and add a directive in your code to System.Web.

  11. Busque todas las cadenas codificadas de forma rígida en el código visibles para los usuarios, como texto de la interfaz de usuario, errores y texto del mensaje.Locate all hard-coded strings in your code that are visible to users, such as UI text, errors, and message text. Reemplácelas por una llamada al método GetGlobalResourceObject utilizando la sintaxis siguiente:Replace them with a call to the GetGlobalResourceObject method using the following syntax:

    HttpContext.GetGlobalResourceObject("Resource File Name", "String ID")  
    
  12. Elija la F5 clave para compilar y ejecutar la aplicación.Choose the F5 key to build and run the application.

  13. En SharePoint, cambie el idioma de presentación predeterminado.In SharePoint, change the display language from the default.

    Las cadenas localizadas aparecen en la aplicación.The localized strings appear in the application. Para mostrar los recursos localizados, el servidor de SharePoint debe tener instalado el paquete de idioma que coincide con la referencia cultural del archivo de recursos.To display localized resources, the SharePoint server must have a language pack installed that matches the resource file's culture.

Vea tambiénSee also

Localizar soluciones de SharePoint Localize SharePoint solutions
Cómo: localizar una característica How to: Localize a feature
Cómo: localizar el marcado ASPX How to: Localize ASPX markup
Cómo: agregar un archivo de recursosHow to: Add a resource file