Comandos checkout y edit
Convierte en grabable el archivo local y cambia su estado Cambio pendiente a "editar" en el área de trabajo. Edit es un alias del comando Checkout. Para obtener más información, vea Cambios Pendientes.
Nota
Cualquier edición efectuada en elementos desprotegidos no se refleja en el servidor de control de versiones de Team Foundation hasta que se realice una operación de protección. Para obtener más información, vea Proteger los cambios pendientes.
Permisos necesarios
Para utilizar el comando checkout, su permiso Desproteger debe estar establecido en Permitir, y debe ser propietario del área de trabajo o tener su permiso global Administrar áreas de trabajo establecido en Permitir. Asimismo, si utiliza la opción /lock con un valor distinto de None, su permiso Bloquear debe estar establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.
tf checkout [/lock:(none|checkin|checkout)] [/recursive]
[/type:encoding] itemspec [/login:username,[password]]
Parámetros
Argumento |
Descripción |
|---|---|
encoding |
Proporciona un valor para la opción /type. Entre las alternativas se incluyen las siguientes: Text, que es un alias para la codificación de Windows actual (Windows-1252 en sistemas de EE.UU.) o Unicode (basado en la marca de orden de bytes o BOM), Binary y todas las demás codificaciones de archivo compatibles con el sistema operativo Windows. También puede utilizar Auto, que detecta el tipo automáticamente. Para obtener más información, vea Administrar tipos de archivo. |
itemspec |
Especifica uno o varios archivos para desproteger. Aquí puede utilizar caracteres comodín. |
username |
Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario. |
Opción |
Descripción |
|---|---|
/type |
Reemplaza manualmente la codificación de archivo que Team Foundation asocia con los archivos especificados. |
/recursive |
Desprotege todos los archivos que coinciden con itemspec en el directorio actual y en todas las subcarpetas del directorio actual. |
/lock |
Impide que otros usuarios puedan proteger o desproteger los archivos especificados. Para obtener más información, vea Introducción a los tipos de bloqueo. Opciones de bloqueo:
|
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server. |
Comentarios
El comportamiento predeterminado del comando checkout se determina en función de si la opción Obtener la última versión del elemento al desprotegerlo está habilitada. Para obtener más información sobre cómo ver o cambiar esta configuración, vea Habilitar el control de versiones de Team Foundation para obtener los últimos archivos en estado de desprotección.
Si Obtener la última versión del elemento al desprotegerlo está habilitada, el comportamiento del comando checkout es similar al comportamiento de desprotección de Visual SourceSafe. Si la última versión del elemento no está en el área de trabajo, Team Foundation obtiene la última versión de Team Foundation Server y la copia en el área de trabajo. Si hay una versión anterior del mismo elemento en el área de trabajo, se sobrescribe con la última versión.
Si Obtener la última versión del elemento al desprotegerlo está deshabilitada, Team Foundation no obtiene la última versión del servidor de control de versiones de Team Foundation durante una operación de desprotección. En su lugar, convierte en grabable la versión del área de trabajo actual. Para obtener más información, vea Obtener el código fuente para el proyecto de equipo.
Puede utilizar tf edit como un alias para checkout.
De forma predeterminada, varios usuarios pueden desproteger al mismo tiempo el mismo elemento con control de versiones. Cuando utiliza tf para desproteger un elemento que tiene cambios pendientes en otra área de trabajo, la información sobre la naturaleza de esos otros cambios se imprime en la línea de comandos. En la mayoría de los entornos de desarrollo de colaboración, es poco probable que realice un cambio en el área de trabajo que represente un posible conflicto de combinación con un cambio pendiente en otra área de trabajo, o viceversa. Team Foundation le permite resolver automáticamente la mayoría de los conflictos que se producen. Para los conflictos que no se pueden resolver automáticamente, utilice el Comando resolve para decidir sin ningún riesgo qué cambio, suyo o realizado por otros usuarios, desea mantener. Si le preocupa que otros usuarios puedan realizar en sus áreas de trabajo cambios que entren en conflicto con sus cambios pendientes, puede utilizar el Status (Comando) para supervisar los cambios recién aplicados a otras áreas de trabajo. Opcionalmente, puede utilizar el Comando lock para impedir que otros usuarios puedan proteger o desproteger hasta que haya protegido o desbloqueado sus propios cambios. Como procedimiento recomendado, utilice el comando lock con precaución y notifique a sus compañeros de equipo por qué lo utiliza y cuándo piensa quitar el bloqueo.
Para obtener más información sobre cómo buscar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.
Ejemplos
En el ejemplo siguiente se convierte 314.cs en grabable en disco y se agrega a la lista de cambios pendientes del área de trabajo.
c:\pi> tf checkout 314.cs
El ejemplo siguiente desprotege 314.cs y 271.cs.
c:\pi>tf checkout 314.cs 271.cs
En el ejemplo siguiente se desprotege page.xsl y se cambia la propiedad de codificación para el tipo de archivo de Team Foundation a text. Text es un alias para la codificación de Windows actual como Windows-1252.
c:\pi>tf checkout /type:text page.xsl
Vea también
Tareas
Desproteger y editar elementos bajo control de versiones
Referencia
Conceptos
Introducción a los tipos de bloqueo
Configuración de desprotección de Team Foundation