CONTROLES DE ARCHIVOS

10
Lenguaj e de Programación II 1 CONCEPTOS DE OBJETOS Y CONTROLES OpenFileDialog: Solicitaalusuarioqueabra un archivo. Esta clase no se puede heredar. Espaciode nombres: System.Windows.Forms Ensamblado: System.Windows.Forms (en system.windows.forms.dll) Comentarios Esta clase permite comprobar si existe un archivo y abrirlo. La propi edad ShowReadOnly determina si aparece una casilla de verificación de sólo lecturaen el cuadrode diálogo. La propiedad ReadOnlyChecked indica sila casilla de verificación de sólo lecturaestáactivada. La mayor parte de la funcionalidaddeesta clase seencuentraenla clase FileDialog . Si desea dar alusuario la capacidadde seleccionar una carpetaen lugar de un archivo, utilice FolderBrowserDialog en su lugar. Ejemplo En el siguienteejemplode código se crea OpenFileDialog, seestablecenvarias propiedades y se muestrael cuadro de diálogo medianteelmétodo CommonDialog.ShowDialog . En el ejemplo se requiere un formulario con Button colocado en ély el espaciode nombres System.IO agregado al mismo. Private Sub button1_Click(sender As Object, e As System.EventArgs) Dim myStream As Stream Dim openFileDialog1 As New OpenFileDialog() openFileDialog1.InitialDirectory = "c:\" openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*" openFileDialog1.FilterIndex = 2 openFileDialog1.RestoreDirectory = True If openFileDialog1.ShowDialog() = DialogResult.OK Then myStream = openFileDialog1.OpenFile() If Not (myStream Is Nothing) Then ' Insert code to read the streamhere. myStream.Close() End If End If End Sub Propiedades públicas (vea también Propiedades protegidas ) Nombre Descripción AddExtension Obtiene o establece un valor que indica si el cuadrode diálogo agrega automáticamente unaextensión a un nombre dearchivo en casode queel usuarioomita dichaextensión. (Se hereda de FileDialog ). CheckFileExists Reemplazado. Obtiene o establece un valor que indica si el cuadrode diálogo muestra unaadvertencia cuando elusuario especifica un nombre dearchivoque no existe. CheckPathExists Obtiene o establece un valor que indica si el cuadrode diálogo muestra unaadvertencia cuando elusuario especifica una ruta deaccesoque no existe. (Se hereda de FileDialog ). Container Obtiene IContainer que contiene Component. (Se hereda de Component). DefaultExt Obtiene o establece laextensión de nombre dearchivopredeterminada. (Se hereda de FileDialog ). DereferenceLinks Obtiene o establece un valor que indica si el cuadrode diálogo devuelve la ubicación del archivo al que hace referenciael accesodirectoobien devuelve la ubicación del accesodirecto (.lnk). (Se hereda de FileDialog ).

description

Controles de manejo de archivos e imagenes en visual net para windows

Transcript of CONTROLES DE ARCHIVOS

Page 1: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 1

CONCEPTOS DE OBJETOS Y CONTROLES

OpenFileDialog:

Solicita al usuario que abra un archivo. Esta clase no se puede heredar.

Espacio de nombres: System.Windows.FormsEnsamblado: System.Windows.Forms (en system.windows.forms.dll)

Comentarios

Esta clase permite comprobar si existe un archivo y abrirlo. La propiedad ShowReadOnly determina si aparece unacasilla de verificación de sólo lectura en el cuadro de diálogo. La propiedad ReadOnlyChecked indica si la casilla deverificación de sólo lectura está activada.

La mayor parte de la funcionalidad de esta clase se encuentra en la clase FileDialog.

Si desea dar al usuario la capacidad de seleccionar una carpeta en lugar de un archivo, utilice FolderBrowserDialog ensu lugar.

Ejemplo

En el siguiente ejemplo de código se crea OpenFileDialog, se establecen varias propiedades y se muestra el cuadrode diálogo mediante el método CommonDialog.ShowDialog. En el ejemplo se requiere un formulario con Buttoncolocado en él y el espacio de nombres System.IO agregado al mismo.

Private Sub button1_Click(sender As Object, e As System.EventArgs)Dim myStream As StreamDim openFileDialog1 As New OpenFileDialog()

openFileDialog1.InitialDirectory = "c:\"openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"openFileDialog1.FilterIndex = 2openFileDialog1.RestoreDirectory = True

If openFileDialog1.ShowDialog() = DialogResult.OK ThenmyStream = openFileDialog1.OpenFile()If Not (myStream Is Nothing) Then

' Insert code to read the stream here.myStream.Close()

End IfEnd If

End Sub

Propiedades públicas (vea también Propiedades protegidas )

Nombre Descripción

AddExtension Obtiene o establece un valor que indica si el cuadro de diálogo agregaautomáticamente una extensión a un nombre de archivo en caso de que elusuario omita dicha extensión. (Se hereda de FileDialog).

CheckFileExists Reemplazado. Obtiene o establece un valor que indica si el cuadro dediálogo muestra una advertencia cuando el usuario especifica un nombrede archivo que no existe.

CheckPathExists Obtiene o establece un valor que indica si el cuadro de diálogo muestrauna advertencia cuando el usuario especifica una ruta de acceso que noexiste. (Se hereda de FileDialog).

Container Obtiene IContainer que contiene Component. (Se hereda de Component).

DefaultExt Obtiene o establece la extensión de nombre de archivo predeterminada.(Se hereda de FileDialog).

DereferenceLinks Obtiene o establece un valor que indica si el cuadro de diálogo devuelve laubicación del archivo al que hace referencia el acceso directo o biendevuelve la ubicación del acceso directo (.lnk). (Se hereda de FileDialog).

Page 2: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 2

FileName Obtiene o establece una cadena que contiene el nombre de archivoseleccionado en el cuadro de diálogo de archivo. (Se hereda deFileDialog).

FileNames Obtiene los nombres de todos los archivos seleccionados en el cuadro dediálogo. (Se hereda de FileDialog).

Filter Obtiene o establece la cadena actual de filtro de nombres de archivo, quedetermina las opciones que aparecen en los cuadros "Guardar comoarchivo de tipo" o "Archivos de tipo" del cuadro de diálogo. (Se hereda deFileDialog).

FilterIndex Obtiene o establece el índice del filtro actualmente seleccionado en elcuadro de diálogo de archivo. (Se hereda de FileDialog).

InitialDirectory Obtiene o establece el directorio inicial que muestra el cuadro de diálogode archivo. (Se hereda de FileDialog).

Multiselect Obtiene o establece un valor que indica si el cuadro de diálogo permiteseleccionar varios archivos.

ReadOnlyChecked Obtiene o establece un valor que indica si la casilla de verificación de sólolectura está activada.

RestoreDirectory Obtiene o establece un valor que indica si el cuadro de diálogo restaura eldirectorio actual antes de cerrarse. (Se hereda de FileDialog).

ShowHelp Obtiene o establece un valor que indica si se muestra el botón Ayuda enel cuadro de diálogo de archivo. (Se hereda de FileDialog).

ShowReadOnly Obtiene o establece un valor que indica si el cuadro de diálogo contieneuna casilla de verificación de sólo lectura.

Site Obtiene o establece ISite de Component. (Se hereda de Component).

SupportMultiDottedExtensions (Se hereda de FileDialog).

Tag Obtiene o establece un objeto que contiene datos sobre el control. (Sehereda de CommonDialog).

Title Obtiene o establece el título del cuadro de diálogo de archivo. (Se heredade FileDialog).

ValidateNames Obtiene o establece un valor que indica si el cuadro de diálogo acepta sólonombres de archivo Win32 válidos. (Se hereda de FileDialog).

Métodos públicos (vea también Métodos protegidos )

Nombre Descripción

CreateObjRef Crea un objeto que contiene toda la información relevante necesaria paragenerar un proxy utilizado para comunicarse con un objeto remoto. (Sehereda de MarshalByRefObject).

Dispose Sobrecargado. Libera los recursos utilizados por el objeto Component. (Sehereda de Component).

Equals Sobrecargado. Determina si dos instancias de Object son iguales. (Se heredade Object).

GetHashCode Sirve como función hash para un tipo concreto. GetHashCode es apropiadopara su utilización en algoritmos de hash y en estructuras de datos como lastablas hash. (Se hereda de Object).

Page 3: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 3

GetLifetimeService Recupera el objeto de servicio de duración actual que controla la directiva deduración de esta instancia. (Se hereda de MarshalByRefObject).

GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).

InitializeLifetimeService Obtiene un objeto de servicio de duración para controlar la directiva deduración de esta instancia. (Se hereda de MarshalByRefObject).

OpenFile Abre el archivo seleccionado por el usuario con permiso de sólo lectura. Lapropiedad FileName especifica el archivo.

ReferenceEquals Determina si las instancias de Object especificadas son la misma instancia.(Se hereda de Object).

Reset Reemplazado. Restablece los valores predeterminados de todas laspropiedades.

ShowDialog Sobrecargado. Ejecuta un cuadro de diálogo común. (Se hereda deCommonDialog).

ToString Devuelve una versión de cadena de este objeto . (Se hereda de FileDialog).

PICTUREBOX

Representa un PictureBox de formularios Windows Forms que se puede agregar a una hoja de cálculo de MicrosoftOffice Excel.

Espacio de nombres: Microsoft.Office.Tools.Excel.ControlsEnsamblado: Microsoft.Office.Tools.Excel (en microsoft.office.tools.excel.dll)

Comentarios

El control Microsoft.Office.Tools.Excel.Controls.PictureBox es diferente de un controlSystem.Windows.Forms.PictureBox. El objeto Microsoft.Office.Tools.Excel.Controls.PictureBox tiene miembrosadicionales que permiten que se agregue a una hoja de cálculo de Excel y le proporcionan métodos y propiedadesadicionales.

No utilice el constructor New para crear un nuevo control PictureBox. Utilice el método AddPictureBox para agregar unnuevo PictureBox a una hoja de cálculo.

PictureBox.SizeMode (Propiedad) =>Indica cómo se muestra la imagen.ComentariosLos valores válidos para esta propiedad se toman de la enumeración PictureBoxSizeMode. De forma predeterminada,en modo Normal, el objeto Image se coloca en la esquina superior izquierda de PictureBox y se recorta la parte de laimagen que es demasiado grande para PictureBox. El uso del valor StretchImage hace que la imagen se estire paraajustarse a PictureBox.

El uso del valor AutoSize hace que el control cambie de tamaño para ajustarse siempre a la imagen. El uso del valorCenterImage hace que la imagen se centre en el área de cliente.

PictureBox.Image (Propiedad) => Obtiene o establece la imagen que muestra PictureBox.

Comentarios

La propiedad Image se establece en el objeto Image que se va a mostrar. Esto se puede realizar en tiempo de diseñoo en tiempo de ejecución.

FileStream (Miembros)

Expone un objeto Stream alrededor de un archivo; se admiten operaciones de lectura y escritura sincrónica yasincrónica.

FileStream (Constructor)

Inicializa una nueva instancia de la clase FileStream.

Page 4: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 4

Lista de sobrecarga

Nombre Descripción

FileStream(IntPtr,FileAccess) Inicializa una nueva instancia de la clase FileStream para el identificador dearchivo especificado, con el permiso de lectura/escritura establecido.

FileStream(SafeFileHandle,FileAccess)

Inicializa una nueva instancia de la clase FileStream para el identificador dearchivo especificado, con el permiso de lectura/escritura establecido.

FileStream(String,FileMode) Inicializa una nueva instancia de la clase FileStream con el modo de creación yla ruta de acceso especificados.

Compatible con .NET Compact Framework.

FileStream(IntPtr,FileAccess,Boolean)

Inicializa una nueva instancia de la clase FileStream para el identificador dearchivo especificado, con el permiso de lectura/escritura establecido y lapropiedad de la instancia de FileStream.

FileStream(SafeFileHandle,FileAccess,Int32)

Inicializa una nueva instancia de la clase FileStream para el identificador dearchivo especificado, con el tamaño de búfer y el permiso de lectura y escrituraespecificados.

FileStream(String,FileMode,FileAccess)

Inicializa una nueva instancia de la clase FileStream con el permiso delectura/escritura, el modo de creación y la ruta de acceso especificados.

Compatible con .NET Compact Framework.

FileStream(IntPtr,FileAccess,Boolean,Int32)

Inicializa una nueva instancia de la clase FileStream para el identificador dearchivo especificado, con el tamaño de búfer, la propiedad de la instancia deFileStream y el permiso de lectura/escritura especificados.

FileStream(SafeFileHandle,FileAccess,Int32,Boolean)

Inicializa una nueva instancia de la clase FileStream para el identificador dearchivo especificado, y con el permiso de lectura y escritura, el tamaño de búfery el estado sincrónico o asincrónico especificados.

FileStream(String,FileMode,FileAccess,FileShare)

Inicializa una nueva instancia de la clase FileStream con el permiso de usocompartido, el permiso de lectura/escritura, el modo de creación y la ruta deacceso especificados.

Compatible con .NET Compact Framework.

FileStream (IntPtr, FileAccess,Boolean,Int32,Boolean)

Inicializa una nueva instancia de la clase FileStream para el identificador dearchivo especificado, con el estado sincrónico o asincrónico, el tamaño de búfer,la propiedad de la instancia de FileStream y el permiso de lectura/escrituraespecificados.

FileStream(String,FileMode,FileAccess,FileShare,Int32)

Inicializa una nueva instancia de la clase FileStream con el tamaño de búfer, elpermiso de lectura/escritura y de uso compartido, el modo de creación y la rutade acceso especificados.

Compatible con .NET Compact Framework.

FileStream(String,FileMode,FileAccess,FileShare,Int32,Boolean)

Inicializa una nueva instancia de la clase FileStream con el estado sincrónico oasincrónico, el tamaño de búfer, el permiso de lectura/escritura y de usocompartido, el modo de creación y la ruta de acceso especificados.

Compatible con .NET Compact Framework.

FileStream(String,FileMode,FileAccess,FileShare,Int32,FileOptions)

Inicializa una nueva instancia de la clase FileStream con la ruta de acceso, elmodo de creación, los permisos de lectura y escritura y de uso compartido, elacceso que otras secuencias de archivos pueden tener al mismo archivo, eltamaño del búfer y otras opciones de archivo que se hayan especificado.

FileStream(String,FileMode,FileSystemRights, FileShare,Int32,FileOptions)

Inicializa una nueva instancia de la clase FileStream con la ruta de acceso, elmodo de creación, los derechos de acceso y el permiso de uso compartido, eltamaño de búfer y opciones de archivo adicionales que se hayan especificado.

Page 5: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 5

FileStream(String,FileMode,FileSystemRights, FileShare,Int32,FileOptions,FileSecurity)

Inicializa una nueva instancia de la clase FileStream con la ruta de acceso, elmodo de creación, los derechos de acceso y el permiso de uso compartido, eltamaño de búfer, las opciones de archivo adicionales, el control de acceso y laseguridad de auditoría que se hayan especificado.

FileStream.Read (Método)

Lee un bloque de bytes de la secuencia y escribe los datos en un búfer dado.

Parámetrosarray

offset

count

Cuando devuelve el método, contiene la matriz de bytes especificada con valores entre offset y (offset +count - 1)) reemplazada por los bytes leídos desde el origen actual.

Desplazamiento de bytes en el parámetro array donde debe comenzar la lectura.

Número máximo de bytes que se pueden leer.

Valor devueltoNúmero total de bytes leídos en el búfer. Puede ser menor que el número de bytes solicitado si ese número de bytes noestá disponible actualmente o cero si se ha alcanzado el final de la secuencia.

Stream.Close (Método)Cierra la secuencia actual y libera todos los recursos (como sockets e identificadores de archivo) asociados a ésta.

Comentarios

Vaciar la secuencia no hará que se vacíe su correspondiente codificador subyacente, a menos que se llameexplícitamente a una implementación de Flush o a Close. Al establecer el valor de AutoFlush en true, los datos delbúfer se volcarán en la secuencia, pero no se volcará el estado del codificador. Esto permite al codificador mantener suestado (caracteres parciales) de forma que sea posible codificar el siguiente bloque de caracteres correctamente. Esteescenario afecta a UTF8 y UTF7 donde ciertos caracteres sólo se pueden codificar después de que el codificador recibael carácter o los caracteres adyacentes.

Se necesita una llamada a Close para operar adecuadamente con una secuencia. Después de la llamada a Close,realizar otras operaciones en la secuencia puede producir excepciones. Si la secuencia ya está cerrada, una llamada aClose no produce ninguna excepción.

Los intentos de manipular la secuencia después de cerrar la secuencia podrían producir una excepciónObjectDisposedException

FileStream.Flush (Método)

Borra todos los búferes de esta secuencia y hace que todos los datos almacenados en el búfer se escriban en eldispositivo subyacente.

Comentarios

Este método reemplaza a Flush.

Vaciar la secuencia no hará que se vacíe su correspondiente codificador subyacente, a menos que se llameexplícitamente a Flush o a Close. Al establecer el valor de AutoFlush en true, los datos del búfer se vacían en lasecuencia, pero no se vacía el estado del codificador. Esto permite al codificador mantener su estado (caracteresparciales) de forma que sea posible codificar el siguiente bloque de caracteres correctamente. Este escenario afecta aUTF8 y UTF7, donde ciertos caracteres sólo se pueden codificar después de que el codificador reciba el carácter o loscaracteres adyacentes.

Debido a que se puede utilizar un búfer para lectura o escritura, Flush realiza las dos funciones siguientes:

1. En el archivo se copia cualquier dato anteriormente escrito en el búfer y se borra dicho búfer excepto en loque se refiere al estado de su codificador.

2. Si CanSeek es true y anteriormente se copiaron los datos del archivo en el búfer para la lectura, disminuye laposición actual dentro del archivo en el número de bytes no leídos del búfer. A continuación se borra el búfer.

FileStream.Write (Método)

Escribe un bloque de bytes en esta secuencia mediante el uso de datos de un búfer.

Page 6: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 6

Parámetrosarray

offset

count

Búfer que contiene los datos que se van a escribir en la secuencia.

Desplazamiento en bytes de base cero de arraydonde se comienzan a copiar los datos en la secuencia actual.

Número máximo de bytes que se deben escribir en la secuencia actual.

Comentarios

Este método reemplaza a Write.

El parámetro offset indica el desplazamiento del byte de array (índice de búfer) donde debe iniciarse la copia, y elparámetro count proporciona el número máximo de bytes que se van a escribir en la secuencia. Si la operación deescritura se ha realizado correctamente, la posición actual de la secuencia avanza según el número de bytes escritos. Sise produce una excepción, la posición actual de la secuencia no experimentará ningún cambio.

Image (Miembros)

Clase base abstracta que proporciona funcionalidad para las clases descendentes Bitmap y Metafile.

Propiedades públicas

Nombre Descripción

Flags Obtiene indicadores de atributo indica para los datos de píxel de Image.

FrameDimensionsList Obtiene una matriz de GUID que representa las dimensiones de los marcos dentrode Image.

Height Obtiene el alto, en píxeles, de Image.

HorizontalResolution Obtiene la resolución horizontal, en píxeles por pulgada, de Image.

Palette Obtiene o establece la paleta de colores utilizada para Image.

PhysicalDimension Obtiene el ancho y el alto de esta imagen.

PixelFormat Obtiene el formato de píxeles de Image.

PropertyIdList Obtiene los identificadores de los elementos de propiedad almacenados en Image.

PropertyItems Obtiene todos los elementos de propiedad (fragmentos de metadatos) almacenadosen Image.

RawFormat Obtiene el formato de Image.

Size Obtiene el ancho y el alto de esta imagen, expresado en píxeles.

Tag Obtiene o establece un objeto que proporciona datos adicionales sobre la imagen.

VerticalResolution Obtiene la resolución vertical, en píxeles por pulgada, de Image.

Width Obtiene el ancho, en píxeles, de Image.Arriba

Métodos públicos (vea también Métodos protegidos )

Nombre Descripción

Clone Crea una copia exacta de este objeto Image.

Page 7: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 7

CreateObjRef Crea un objeto que contiene toda la información relevante necesaria paragenerar un proxy utilizado para comunicarse con un objeto remoto. (Sehereda de MarshalByRefObject).

Dispose Sobrecargado. Libera todos los recursos utilizados por Image.

Equals Sobrecargado. Determina si dos instancias de Object son iguales. (Se heredade Object).

FromFile Sobrecargado. Crea un objeto Image a partir del archivo especificado.

FromHbitmap Sobrecargado. Crea un objeto Bitmap a partir de un identificador deWindows.

FromStream Sobrecargado. Crea un objeto Image a partir de la secuencia de datosespecificada.

GetBounds Obtiene los límites de la imagen en la unidad especificada.

GetEncoderParameterList Devuelve información sobre los parámetros que admite el codificador deimágenes especificado.

GetFrameCount Devuelve el número de marcos de la dimensión especificada.

GetHashCode Sirve como función hash para un tipo concreto. GetHashCode es apropiadopara su utilización en algoritmos de hash y en estructuras de datos como lastablas hash. (Se hereda de Object).

GetHowFromImage

GetLifetimeService Recupera el objeto de servicio de duración actual que controla la directiva deduración de esta instancia. (Se hereda de MarshalByRefObject).

GetPixelFormatSize Devuelve la profundidad de color, en número de bits por píxel, del formatode píxeles especificado.

GetPropertyItem Obtiene el elemento de propiedad especificado de Image.

GetThumbnailImage Devuelve una miniatura de Image.

GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).

InitializeLifetimeService Obtiene un objeto de servicio de duración para controlar la directiva deduración de esta instancia. (Se hereda de MarshalByRefObject).

IsAlphaPixelFormat Devuelve un valor que indica si el formato de píxeles de Image contieneinformación alfa.

IsCanonicalPixelFormat Devuelve un valor que indica si el formato de píxeles es 32 bits por píxel.

IsExtendedPixelFormat Devuelve un valor que indica si el formato de píxeles es 64 bits por píxel.

ReferenceEquals Determina si las instancias de Object especificadas son la misma instancia.(Se hereda de Object).

RemovePropertyItem Quita el elemento de propiedad especificado de Image.

RotateFlip Este método gira, voltea o gira y voltea el objeto Image.

Save Sobrecargado. Guarda esta imagen en la secuencia especificada con elformato especificado.

SaveAdd Sobrecargado. Agrega la información del objeto Image especificado a esteobjeto Image. El objeto EncoderParameters especificado determina cómose incorpora la nueva información a la imagen existente.

Page 8: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 8

SelectActiveFrame Selecciona el marco que especifican la dimensión y el índice.

SetPropertyItem Almacena un elemento de propiedad (fragmento de metadatos) en Image.

ToString Devuelve una clase String que representa la clase Object actual. (Se heredade Object).

DateTime (Miembros)

Representa un instante de tiempo, normalmente expresado en forma de fecha y hora del día.

Inicializa una nueva instancia de la estructura DateTime.

Lista de sobrecarga

Nombre Descripción

DateTime(Int64) Inicializa una nueva instancia de la estructura DateTime en un número depasos especificado.

Compatible con .NET Compact Framework.

DateTime(Int64,DateTimeKind) Inicializa una nueva instancia de la estructura DateTime en el número depasos y hora universal coordinada (UTC) u hora local especificados.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32) Inicializa una nueva instancia de la estructura DateTime en el año, mes ydía especificados.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32,Calendar)

Inicializa una nueva instancia de la estructura DateTime en el año, mes ydía especificados para el calendario determinado.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32,Int32,Int32,Int32)

Inicializa una nueva instancia de la estructura DateTime en el año, mes, día,hora, minuto y segundo especificados.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32,Int32,Int32,Int32,Calendar)

Inicializa una nueva instancia de la estructura DateTime en el año, mes, día,hora, minuto y segundo especificados para el calendario indicado.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32,Int32,Int32,Int32,DateTimeKind)

Inicializa una nueva instancia de la estructura DateTime en el año, mes, día,hora, minuto, segundo, y hora universal coordinada (UTC) u hora localespecificados.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32,Int32,Int32,Int32,Int32)

Inicializa una nueva instancia de la estructura DateTime en el año, mes, día,hora, minuto, segundo y milisegundo especificados.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32,Int32,Int32,Int32,Int32,Calendar)

Inicializa una nueva instancia de la estructura DateTime en el año, mes, día,hora, minuto, segundo y milisegundo especificados para el calendarioindicado.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32,Int32,Int32,Int32,Int32,DateTimeKind)

Inicializa una nueva instancia de la estructura DateTime en el año, mes, día,hora, minuto, segundo, milisegundo, y hora universal coordinada (UTC) u

Page 9: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 9

hora local especificados.

Compatible con .NET Compact Framework.

DateTime(Int32,Int32,Int32,Int32,Int32, Int32, Int32, Calendar,DateTimeKind)

Inicializa una nueva instancia de la estructura DateTime en el año, mes, día,hora, minuto, segundo, milisegundo, y hora universal coordinada (UTC) uhora local especificados para el calendario indicado.

Compatible con .NET Compact Framework

Now Obtiene un objeto DateTime que se establece en la fecha y hora actual de este equipo, expresada como horalocal.

DateTime.ToFileTime (Método)

Convierte el valor del objeto DateTime actual en una hora de archivo de Windows.

Comentarios

La hora de un archivo de Windows es un valor de 64 bits que representa el número de intervalos de 100 nanosegundosque han transcurrido desde la medianoche (00:00 horas) del 1 de enero de 1601 d.C. (Era Cristiana), hora universalcoordinada (UTC). Windows utiliza una hora de archivo para registrar el momento en que una aplicación crea, obtieneacceso o escribe en un archivo.

Las versiones anteriores del método ToFileTime suponen que el objeto DateTime actual es una hora local. A partir dela versión 2.0 de .NET Framework, el método ToFileTime utiliza la propiedad Kind para determinar si el objetoDateTime actual es una hora local, una hora UTC o una hora de tipo no especificado que se trata como hora local.

CType (Función)

Devuelve el resultado de convertir explícitamente una expresión a un tipo de datos, objeto, estructura, clase o interfaz.

CType(expression, typename)

Partes

expressionCualquier expresión válida. Si el valor de expression está fuera del intervalo permitido portypename, Visual Basic produce una excepción.

typenameCualquier expresión válida dentro de una cláusula As de una instrucción Dim, es decir, elnombre de cualquier tipo de datos, objeto, estructura, clase o interfaz.

Comentarios

CType se compila en línea, es decir, el código de conversión forma parte del código que evalúa la expresión. Enalgunos casos, no se produce ninguna llamada a un procedimiento para llevar a cabo la conversión, lo que acelera laejecución.

Si no se ha definido ninguna conversión de expression a typename, por ejemplo de Integer a Date, Visual Basicmuestra un mensaje de error de compilación.

Si en una conversión se produce un error en tiempo de ejecución, se produce la excepción correspondiente. Si seproduce un error en una conversión de restricción, OverflowException es el resultado más común. Si la conversión esindefinida, se produce una excepción InvalidCastException. Esto puede pasar, por ejemplo, si expression es de tipoObject y su tipo en tiempo de ejecución no tiene ninguna conversión a typename.

Si el tipo de datos de expression o typename es una clase o estructura que ha definido, puede definir CType en dichaclase o estructura como un operador de conversión. Esto hace que CType actúe como un operador sobrecargado. Deeste modo, puede controlar el comportamiento de las conversiones que tienen como destino o como origen la clase oestructura, incluidas las excepciones que se pueden producir.

SobrecargaEl operador CType también se puede sobrecargar en una clase o la estructura definida fuera del código. Si el códigorealiza conversiones que tienen como destino o como origen una clase o estructura de este tipo, asegúrese de conocerel comportamiento de su operador CType. Para obtener más información, vea Procedimientosdeoperador.

Page 10: CONTROLES DE ARCHIVOS

Lenguaje de Programación II 10

Ejemplo

En el ejemplo siguiente se utiliza la función CType para convertir una expresión al tipo de datosespecificado.

Dim testNumber As Long = 1000

' The following line of code sets testNewType to 1000.0.

Dim testNewType As Single = CType(testNumber, Single)

String.IsNullOrEmpty (Método)

Indica si el valor del objeto String especificado es referencia de objeto null (Nothing en Visual Basic) o una cadenaEmpty.

Parámetrosvalue

Referencia de tipo String .

Valor devuelto

Es true si el valor del parámetro value es referencia de objeto null (Nothing en Visual Basic) o una cadena vacía ("");en caso contrario, es false.

Comentarios

IsNullOrEmpty es un método útil que permite comprobar simultáneamente si el valor de un objeto String esreferencia de objeto null (Nothing en Visual Basic) o Empty.