Pues eso… algo tan simple como usar en .NET MAUI una DLL creada a partir de un proyecto del tipo class library, puede ser toda una odisea. Te lo explico para que te quede claro.
Como ya sabrás, puedes crear proyectos del tipo class library para añadirlos como referencia a otros proyectos que usen esa DLL o biblioteca de clases. Algo que es bastante común en cualquier aplicación para .NET ya sea .NET Framework como para .NET a secas incluido los proyectos para aplicaciones móviles con Xamarin.Forms. En estes último, lo que se suele hacer es usar una DLL compilada para .NET Standard. Hasta aquí todo bien.
La idea de usar una biblioteca de clases es para reutilizar el código en proyectos diferentes, es decir, creas la biblioteca de clases con cierta funcionalidad y esa misma biblioteca de clases la utilizas en proyectos diferentes. Al menos si esos tipos de proyectos son compatibles en el sentido de usar el mismo .NET.
Y como ahora estoy haciendo pruebas de Google Cloud Natural Language, pues pensé crear algún proyecto para .NET MAUI que usara esa API. Y como ya tenía el código de ciertas clases creado como proyecto DLL (Class Library) pensé agregar la referencia al proyecto de .NET MAUI y… ¡yaumate! (una expresión de mi zona que quiere decir algo así como… ¡tararí que te vi! o… ¡que te lo has creído!)
¡Y así fue! ¡Me lo creí! Pensaba que en .NET MAUI las cosas seguirían siendo como en el resto de .NET, pero no…
De hecho, hasta creé una class library usando la plantilla de MAUI, pero ni por esas… el proyecto de .NET MAUI nada más que daba errores de que no se podía tener referencia a esas clases definidas en la DLL (o class library).
La solución que tomé fue añadir directamente el código de esas clases en el mismo proyecto de .NET MAUI y así funcionó, pero no era eso lo que yo pretendía, ya que además del proyecto para .NET MAUI tenía otros proyectos: de tipo consola de Windows Forms para C# y Visual Basic y en todos ellos pretendía usar la misma DLL o biblioteca de clases.
Pero la solución buena ha sido creando una DLL (proyecto del tipo Class Library), crear un paquete de NuGet y usar ese paquete como referencia en lugar de una referencia al proyecto de tipo class library.
Decirte que esa referencia, al proyecto, sí que funciona en los proyectos de tipo consola o de tipo Windows Forms, tanto para VB como para C#, pero no si el proyecto es de .NET MAUI.
Te lo explico por si alguna vez te pasa esto… para que no te calientes la cabeza ni pierdas todo el tiempo que yo he perdido.
Y para muestra, el proyecto ElizaNET y el correspondiente Eliza MAUI (los enlaces van al repositorio de GitHub), que ambos usan una DLL compilada para .NET 7.0 y que funcionan a la perfección (salvo los bugs que se puedan producir en esa biblioteca de clases, que algunos pueden surgir).
Esos dos proyectos usan el código publicado en NuGet de Eliza gcnl Library que ahora va por la versión 1.0.2.
El código fuente de esa DLL (o paquete de NuGet) está en este enlace (dentro del repositorio ElizaNET).
Y esto es todo… espero que te sea de utilidad. Esa es la intención.
Con esas API podrás analizar textos (también en español) y ver las palabras que la forman (tokens), su estructura sintáctica, etc.
Nota: Para usar este código tendrás que crearte una cuenta en Google Cloud, generar una «key» para usarla y poco más, todos los pasos están explicados en este enlace (el código de ejemplo es para C#, pero te servirá.
Pasos para crear un proyecto usando dotnet (cli):
– Abre una ventana de consola (o terminal) – Posicionarse en la carpeta donde crear el proyecto – Crear el proyecto dotnet new console -n <nombre-proyecto> dotnet new console -lang VB -n <nombre-proyecto> – Cambiar al directorio del proyecto cd <nombre-proyecto> – Añadir el paquete de Google Cloud Natural Language API dotnet add package Google.Cloud.Language.V1 – Copiar el fichero key.json con las claves y permisos – Ver estos pasos para crearla: https://codelabs.developers.google.com/codelabs/cloud-natural-language-csharp#3 – En IAM, añadir la cuenta creada (incluida en el fichero key.json) en +OTORGAR ACCESO Solo estará la principal y/o las otras añadidas – Si se ha usado otra cuenta, estará en IAM>Cuentas de Servicio – Modificar Program.cs (o Program.vb) para usar el código que accede a la API de Natural Language – Ejecutar el código dotnet run
Notas: – Debes crear una variable de entorno en Windows, (lo puedes hacer desde la misma consola) indicando el path donde estará el fichero key.json. – Lo que yo hago es copiar ese fichero en la carpeta del ejecutable y la variable de entorno la defino de esta forma: set GOOGLE_APPLICATION_CREDENTIALS=key.json – Puedes modificar el fichero del proyecto y añadir lo siguiente:
Pues eso… este post es para tener actualizada la utilidad CrearClaseTabla que en su día (allá por 2004) creé para generar o crear clases para acceder a una base de datos de SQL Server o de Access.
La idea de esta utilidad (la aplicación y la DLL que es la que hace el trabajo) es crear clases de Visual Basic o C# de cada tabla de la base de datos, con idea de facilitar el acceso por código a esas tablas.
En la última actualización de hoy 1 de octubre de 2022 se contempla, entre otras cosas, la definición de variables asignadas sin indicar el tipo (inferencia de tipos) además de convertir adecuadamente las conversiones de tipo de Visual Basic a C# (aunque en el código solo uso CInt).
Nota: He creado el proyecto para .NET 6.0 (Windows) y está disponible en GitHub: gsCrearClasesTablas. Por ahora el código es el mismo en este nuevo proyecto como en el que referencio en este post/artículo que es para .NET Framework 4.8.1
El código «base» que utilizo es el que yo uso con Visual Basic y la clase CrearClase apoyada de ConvLag se encarga de generar el código de Visual Basic o el de C#.
Por ejemplo, el código que te muestro primero, en el generador de clases lo defino como te muestro en el segundo bloque de código:
Este es el código en que me he basado:
cmd.Transaction = tran
cmd.ExecuteNonQuery()
' Si llega aquí es que todo fue bien,
' por tanto, llamamos al método Commit.
tran.Commit()
msg = "Se ha actualizado el Cliente correctamente."
Catch ex AsException
msg = $"ERROR: {ex.Message}"
' Si hay error, deshacemos lo que se haya hecho.
Try
If tran IsNotNothingThen
tran.Rollback()
EndIf
Catch ex2 AsException
msg = $" (ERROR RollBack: {ex.Message})"
EndTry
Finally
con.Close()
EndTry
EndUsing
Return msg
Este es el código interno que uso en el conversor (el método generarClase): En los comentarios está el código mostrado antes y el equivalente para generar el código de VB o de C#.
sb.AppendLine()
' cmd.Transaction = tran
sb.AppendFormat(" {0}{1}", ConvLang.Asigna("cmd.Transaction", "tran"), vbCrLf)
' cmd.ExecuteNonQuery()
sb.AppendFormat(" {0}{1}", ConvLang.Instruccion("cmd.ExecuteNonQuery()"), vbCrLf)
sb.AppendLine()
' ' Si llega aquí es que todo fue bien,
' ' por tanto, llamamos al método Commit
sb.AppendFormat(" {0}{1}", ConvLang.Comentario(" Si llega aquí es que todo fue bien,"), vbCrLf)
sb.AppendFormat(" {0}{1}", ConvLang.Comentario(" por tanto, llamamos al método Commit."), vbCrLf)
' tran.Commit()
sb.AppendFormat(" {0}{1}", ConvLang.Instruccion("tran.Commit()"), vbCrLf)
sb.AppendLine()
' msg = "Se ha actualizado el Cliente correctamente."
sb.AppendFormat(" {0}{1}", ConvLang.Asigna("msg", """Se ha actualizado un " & nombreClase & " correctamente."""), vbCrLf)
sb.AppendLine()
' Catch ex As Exception
sb.AppendFormat(" {0}{1}", ConvLang.Catch("ex", "Exception"), vbCrLf)
' msg = $"ERROR: {ex.Message}"
sb.AppendFormat(" {0}{1}", ConvLang.Asigna("msg", "$""ERROR: {ex.Message}"""), vbCrLf)
' ' Si hay error, deshacemos lo que se haya hecho
sb.AppendFormat(" {0}{1}", ConvLang.Comentario(" Si hay error, deshacemos lo que se haya hecho."), vbCrLf)
' Try
sb.AppendFormat(" {0}{1}", ConvLang.Try(), vbCrLf)
' Añadir comprobación de nulo en el objeto tran (17-abr-21)
' If tran IsNot Nothing Then
sb.AppendFormat(" {0}{1}", ConvLang.If("tran", "IsNot", "Nothing"), vbCrLf)
' tran.Rollback()
sb.AppendFormat(" {0}{1}", ConvLang.Instruccion("tran.Rollback()"), vbCrLf)
' End If
sb.AppendFormat(" {0}{1}", ConvLang.EndIf, vbCrLf)
' Catch ex2 As Exception
sb.AppendFormat(" {0}{1}", ConvLang.Catch("ex2", "Exception"), vbCrLf)
' msg &= $" (ERROR RollBack: {ex.Message})"
sb.AppendFormat(" {0}{1}", ConvLang.Asigna("msg", "$""ERROR RollBack: {ex2.Message}"""), vbCrLf)
' End Try
sb.AppendFormat(" {0}{1}", ConvLang.EndTry(), vbCrLf)
sb.AppendLine()
sb.AppendFormat(" {0}{1}", ConvLang.Finally, vbCrLf)
' If Not (con is nothing) then
sb.AppendFormat(" {0}{1}", ConvLang.If("", "Not", "(con Is Nothing)"), vbCrLf)
' con.Close()
sb.AppendFormat(" {0}{1}", ConvLang.Instruccion("con.Close()"), vbCrLf)
' End If
sb.AppendFormat(" {0}{1}", ConvLang.EndIf, vbCrLf)
' End Try
sb.AppendFormat(" {0}{1}", ConvLang.EndTry(), vbCrLf)
sb.AppendLine()
' End Using
sb.AppendFormat(" {0}{1}", ConvLang.EndUsing(), vbCrLf)
sb.AppendLine()
' Return msg
sb.AppendFormat(" {0}{1}", ConvLang.Return("msg"), vbCrLf)
Y el código generado de Visual Basic sería como te he mostrado arriba y el de C# sería más o menos este:
cmd.Transaction = tran;
cmd.ExecuteNonQuery();
// Si llega aquí es que todo fue bien,// por tanto, llamamos al método Commit.
tran.Commit();
msg = "Se ha actualizado un Producto correctamente.";
}catch(Exception ex){
msg = $"ERROR: {ex.Message}";
// Si hay error, deshacemos lo que se haya hecho.try{
if(tran != null ){
tran.Rollback();
}
}catch(Exception ex2){
msg = $"ERROR RollBack: {ex2.Message}";
}
finally{
if( ! (con == null )){
con.Close();
}
}
}
return msg;
Como ves, no está bien formateado, (es el código generado directamente) pero si lo pegas en Visual Studio te lo formateará bien y lo coloreará mejor 😉
Y para muestra, ese trozo de código en un fichero abierto en Visual Studio 2022: (Aunque todo hay que decirlo, en VB lo formatea bien, aunque solo sea un fichero abierto directamente (sin formar parte de ningún proyecto) mientras que en C# le he tenido casi que dar el formato manualmente, en fin…)
cmd.Transaction = tran;
cmd.ExecuteNonQuery();
// Si llega aquí es que todo fue bien,
// por tanto, llamamos al método Commit.
tran.Commit();
msg = "Se ha actualizado un Producto correctamente.";
}
catch(Exception ex)
{
msg = $"ERROR: {ex.Message}";
// Si hay error, deshacemos lo que se haya hecho.
try
{
if (tran != null)
{
tran.Rollback();
}
}
catch(Exception ex2)
{
msg = $"ERROR RollBack: {ex2.Message}";
}
finally
{
if (!(con == null))
{
con.Close();
}
}
}
Pero la idea es que te quedes con lo que la clase hace.
También es cierto que yo suelo generar el código para Visual Basic y es lo que realmente he probado más, hoy he estado viendo cómo lo generaría para C# y he estado haciendo algunas correcciones (que he indicado en el fichero Revisiones.md publicado con GitHub).
Una captura de la utilidad tal como la tengo a día 1 de octubre de 2022.
Figura 1. La utilidad en funcionamiento a día de hoy 1 de octubre de 2022
Y esto es todo amigo (o amiga), ya sabes, si quieres participar en el proyecto para mejorarlo, puedes hacerlo, creo que en algún sitio indico cómo avisarme de los errores que encuentres y cómo actualizar el fichero Revisiones.txt que ahora es Revisiones.md.
Y si quieres usarlo sin más aportaciones, estaría bien que hicieras una pequeña aportación monetaria en PayPal (no es obligatorio, pero es de agradecer).
En breve publicaré en GitHub el ejecutable compilado con .NET Framework 4.8.1.
Por cierto, en el proyecto (los dos) he incluido un fichero de nombre seguro (strong name) para firmar los ensamblados, ese fichero (elGuille_compartido.snk) lo puedes usar «libremente» (ya sabes todo está con la licencia MIT) para firmar los ensamblados con nombre seguro.
Espero que te sirva de utilidad.
Nos vemos. Guillermo
P.S. Sería interesante convertir el proyecto para .NET 6 (o 7) y también usando el código completamente en C#. Actualmente está creado para usar con .NET Framework 4.8.1 y escrito enteramente en Visual Basic.
P.S.2 Ya está creado el proyecto para .NET 6.0 (net6.0-windows) y publicado en GitHub (gsCrearClasesTablas).
Pues eso… ahora esto de los ficheros con la extensión .json es lo que está en la «onda» y… pues habrá que aprovecharlo que incluso es fácil usarlo en las aplicaciones de .NET.
Espero que no sirva de precedente, pero en este post no hay ejemplo para Visual Basic, solo para C#. No es porque yo abandone mis END IFs y me pase definitivamente a las llaves y puntos y comas, es porque acabo de terminar una clase «serializable» y la he escrito en C# y por vagancia, no he querido crear un ejemplo en Visual Basic. Eso sí, esta clase la utilizo desde código de Visual Basic, ya que en C# solo he hecho la clase, y como he comprobado que los ejemplos que he consultado no hacían bien el trabajo, me he decidido a escribir esta entra en el blog (post).
La clase que serializo es muy simple, es para «recordar» los tamaños de las columnas de, en mi caso, un DataGridView. Esa cuadrícula utiliza distintos tipos de nombres y anchos de columnas, por tanto, el objeto que contiene los valores está formado por un diccionario en el que la clave es una cadena (string), para saber el tipo de datos mostrados, y los valores es otro diccionario de tipo entero en la clave y el valor que guardará serán el índice de la columna y el ancho de la misma.
Esa propiedad está definida de la siguiente forma:
///<summary>
/// Diccionario para el tipo de listado y los valores de cada columna
/// (por índice) y el ancho de la columna.
///</summary>
[JsonPropertyName("anchos")]
publicDictionary<string, Dictionary<int, int>> Anchos { get; set; } = new();
El atributo JsonPropertyName es el que le indica al compilador que esa propiedad es serializable y que está enlazada con el valor anchos del fichero .json.
Esta es la parte fácil.
Ahora hay que leer y guardar los datos en el fichero de texto con la extensión que queramos, pero que en este ejemplo utilizo el valor estándar: .json.
Y estos son los métodos principales para guardar (Save) y leer (Load) el contenido de la clase en el fichero. Save guarda el contenido de la clase en el fichero (lo serializa) y Load lee el contenido del fichero (lo de-serializa) y lo asigna a un objeto del tipo de la clase del tipo donde está definida esa propiedad. No te líes. Es más sencillo el código que explicar lo que hace… 😉
///<summary>
/// Carga los valores del fichero indicado.
///</summary>
///<paramname="fileName">El path del fichero a leer y devolver el contenido.</param>
///<returns>El objeto leído del fichero indicado.</returns>
privatestaticAnchoColumnas Load(string fileName)
{
// Abrir el fichero para leer, compartido para lectura y escritura.
usingvar stream = newFileStream(fileName,
FileMode.OpenOrCreate,
FileAccess.Read,
FileShare.ReadWrite);
// Si tiene contenido, deserializarlo, si no, devolver un valor nulo.
if (stream.Length > 0)
returnJsonSerializer.Deserialize<AnchoColumnas>(stream);
else
returnnull;
}
///<summary>
/// Guarda los datos de tipo AnchoColumnas indicado.
///</summary>
///<paramname="anchosColumnas"></param>
///<paramname="fileName"></param>
///<returns></returns>
privatestaticvoid Save(AnchoColumnas anchosColumnas, string fileName)
{
// Abrir el fichero para escribir, compartido para lectura y escritura.
usingvar stream = newFileStream(fileName,
FileMode.OpenOrCreate,
FileAccess.Write,
FileShare.ReadWrite);
// Que se indente el contenido.
var options = newJsonSerializerOptions { WriteIndented = true };
// Guardar (serializar) el contenido de la clase.
JsonSerializer.Serialize<AnchoColumnas>(stream, anchosColumnas, options);
}
En mi caso, he creado otros dos métodos llamados Guardar y Leer en el que asigno el nombre del fichero que contendrá los datos serializados de la clase. Ese fichero está en el path del ejecutable.
Este es el código:
///<summary>
/// Guardar los datos de los anchos de los listados.
///</summary>
///<paramname="anchosColumnas"></param>
publicstaticvoid Guardar(AnchoColumnas anchosColumnas)
{
// El fichero está en la carpeta del ejecutable.
var fic = Path.Combine(Application.StartupPath, "AnchosColumnas.json");
Save(anchosColumnas, fic);
}
///<summary>
/// Leer los anchos de las columnas.
///</summary>
///<returns></returns>
publicstaticAnchoColumnas Leer()
{
// El fichero está en la carpeta del ejecutable.
var fic = Path.Combine(Application.StartupPath, "AnchosColumnas.json");
return Load(fic);
}
Como puedes comprobar, el método Guardar recibe como parámetro la clase a serializar y el método Leer devuelve un objeto con la clase deserializada (o un valor nulo en caso de que aún no tenga contenido el fichero).
La parte interesante está en los métodos Save y Load, ya que utilizo código «seguro» a la hora de leer o escribir en un fichero que no exista. Y el truco está en crear el objeto de tipo Stream usando FileStream en lugar de usar los métodos OpenRead u OpenWrite de la clase File, ya que, para usar esos dos métodos habría que hacer comprobaciones si existen, si están compartidos, etc., etc., etc.
Por último, en esa misma clase tengo un método (también compartido o estático) para acceder a la información. Es una propiedad de solo lectura, que se encarga de asignar/leer el objeto si debe hacerlo (cuando inicialmente no está asignado).
Este es el código:
privatestaticAnchoColumnas _AnchosColumnas = null;
///<summary>
/// Los anchos de las columnas de los listados.
///</summary>
publicstaticAnchoColumnas AnchosColumnas
{
get
{
if (_AnchosColumnas == null)
{
_AnchosColumnas = Leer();
if (_AnchosColumnas == null)
{
_AnchosColumnas = new();
}
}
return _AnchosColumnas;
}
Y finalmente te muestro cómo uso esa clase desde el código que tengo en Visual Basic:
Primero para asignar las columnas al objeto DataGridView (en el código indicado por lvDatos) y después cuándo guardar los nuevos valores, cosa que hago en el evento ColumnWidthChanged.
La asignación de los anchos guardados lo hago en un método (con más código del mostrado) en el que asigno los valores de las columnas, tanto el texto a mostrar como el ancho, y por supuesto el número de las mismas.
Este es el código para leer los valores guardados y asignarlos a las columnas del objeto lvDatos:
' Asignar los anchos que estén guardados. (22/abr/22 20.34)
IfAnchoColumnas.AnchosColumnas.Anchos.ContainsKey(value.ToString()) = FalseThen
AnchoColumnas.AnchosColumnas.Anchos.Add(value.ToString(),
NewDictionary(OfInteger, Integer))
EndIf
Dim cols = AnchoColumnas.AnchosColumnas.Anchos(value.ToString())
If cols.Keys.Count = 0 Then
For i = 0 To lvDatos.Columns.Count - 1
cols.Add(i, lvDatos.Columns(i).Width)
Next
Else
For i = 0 To cols.Keys.Count - 1
lvDatos.Columns(i).Width = cols(i)
Next
d EndIf
El valor de la variable «value» es el nombre de la enumeración que utilizo y que es un valor asignado como parámetro de este método (recuerda que esto es solo un extracto en el que se asignan los valores leídos, si es que existe el fichero con esos valores ya guardados).
Y para finalizar, el código del evento ColumnWidthChanged, en el que, tengo puesto una comprobación de si se está inicializando (cuando se carga el formulario) con idea de que no se guarden los valores iniciales que tenga.
PrivateSub lvDatos_ColumnWidthChanged(sender AsObject, e AsDataGridViewColumnEventArgs) Handles lvDatos.ColumnWidthChanged
' Cambiar el ancho de las columnas de los totales (10/mar/22 04.28)
' al cambiar el del principal.
If inicializando ThenReturn
' Asignar y guardar los valores. (22/abr/22 20.39)
Dim value = TipoListado.ToString()
With lvDatos
IfAnchoColumnas.AnchosColumnas.Anchos.ContainsKey(value) = FalseThen
AnchoColumnas.AnchosColumnas.Anchos.Add(value, NewDictionary(OfInteger, Integer))
EndIf
' Asegurarse que se asignan correctamente.
Dim cols = AnchoColumnas.AnchosColumnas.Anchos(value)
cols.Clear()
For i = 0 To .Columns.Count - 1
cols.Add(i, .Columns(i).Width)
Next
AnchoColumnas.Guardar(AnchoColumnas.AnchosColumnas)
EndWith
EndSub
Y esto es todo… otro día pondré el código para Visual Basic de la clase y un ejemplo de cómo usarla escrito en C#, pero eso será en otra ocasión 😉
Pues eso… yo pensaba que todas las unidades (de tipo pendrive) USB devolverían un valor del tipo DriveType.Removable, pero resulta que no. Al igual que ocurre con los discos duros conectados por USB, los pendrives también pueden ser de tipo fijo (DriveType.Fixed).
Y lo que te voy a mostrar es el código para C# y Visual Basic (usando .NET 5.0 con Visual Studio 2019) para saber todas las unidades conectadas por USB (sean fijas o extraíbles), además de una función para saber si el path indicado está o no en una unidad extraíble.
También incluyo un ejemplo de cómo saber las unidades (y el tipo de unidad que es) usando el «clásico» método para saber las unidades instaladas con DriveInfo.GetDrives().
En la siguiente captura puedes ver el programa funcionando en mi equipo.
Imagen 1. El programa funcionando.
En mi equipo tengo conectado 2 discos duros por usb (letras S y T), un pendrive de tipo fijo (letra F) y uno de tipo extraíble (letra G).
En la primera lista (usando el método GetDrives de la clase DriveInfo) el único que se muestra como «extraíble» es el disco G, el resto se muestran como fijos (fixed). En la segunda lista se muestran las unidades extraíbles, sean o no fijas.
Ya sin más rollos te muestro el código tanto para C# como para Visual Basic.
El código lo puedes descargar de GitHub (UnidadesExternas), pero si quieres crearlo por tu cuenta, decirte que he tenido que añadir una referencia al paquete de Nuget System.Management versión 5.0 ya que estos proyectos los he creado con Visual Studio 2019 y esa versión de Visual Studio no utiliza versiones posteriores a .NET 5.0.
El tipo de proyecto es Consola de Windows, aunque he tenido que cambiar el tipo del proyecto, ya que al elegir que sea para .NET 5.0 ha intentado usarlo para cualquier plataforma. En el fichero del proyecto (de C# o de VB) busca <TargetFramework> y cambia net5.0 por net5.0-windows, ya que System.Management solo se puede usar en el sistema operativo Windows.
Nota: Comentarte que el código (de C#) está basado en dos ejemplos encontrados en la red y de esos dos códigos de ejemplo he sacado el código del método GetUsbDriveLetters. Estos son los enlaces que he usado: El primero es prácticamente el usado en ese código, pero añadiendo la comprobación de que MediaType también pueda ser External, que saqué del segundo. https://stackoverflow.com/a/31560283/14338047 https://stackoverflow.com/a/10018438/14338047
Código de C# de la utilidad para saber las unidades externas
publicclassUSBUtil
{
///<summary>
/// Comprueba si es una unidad externa.
///</summary>
///<paramname="elPath">Path completo del que se extraerá la letra de unidad.</param>
///<returns></returns>
publicstaticbool EsUnidadExterna(string elPath)
{
var disco = Path.GetPathRoot(Path.GetFullPath(elPath));
var usbD = GetUsbDriveLetters();
return usbD.Contains(disco);
}
// Código basado en dos ejemplos de "la red".
// https://stackoverflow.com/a/31560283/14338047
// https://stackoverflow.com/a/10018438/14338047
///<summary>
/// Las letras de las unidades externas conectadas por USB.
///</summary>
///<returns></returns>
publicstatic List<string> GetUsbDriveLetters()
{
// Hay que usar External para que también tenga en cuenta los USB de tipo fijo.
var usbDrivesLetters = from drive innew ManagementObjectSearcher("select * from Win32_DiskDrive WHERE MediaType like '%External%' OR InterfaceType='USB'").Get().Cast<ManagementObject>()
from o in drive.GetRelated("Win32_DiskPartition").Cast<ManagementObject>()
from i in o.GetRelated("Win32_LogicalDisk").Cast<ManagementObject>()
selectstring.Format("{0}\\", i["Name"]);
return usbDrivesLetters.ToList();
}
}
Código de Visual Basic de la utilidad para saber las unidades externas
PublicClassUSBUtil'''<summary>''' Comprueba si es una unidad externa.'''</summary>'''<param name="elPath">Path completo del que se extraerá la letra de unidad.</param>'''<returns></returns>PublicSharedFunction EsUnidadExterna(elPath AsString) AsBooleanDim disco = Path.GetPathRoot(Path.GetFullPath(elPath))
Dim usbD = GetUsbDriveLetters()
Return usbD.Contains(disco)
EndFunction'''<summary>''' Las letras de las unidades externas conectadas por USB.'''</summary>'''<returns></returns>PublicSharedFunction GetUsbDriveLetters() As List(OfString)
' Hay que usar External para que también tenga en cuenta los USB de tipo fijo.Dim usbDrivesLetters = From drive InNew ManagementObjectSearcher("select * from Win32_DiskDrive WHERE MediaType like '%External%' OR InterfaceType='USB'").[Get]().Cast(Of ManagementObject)()
From o In drive.GetRelated("Win32_DiskPartition").Cast(Of ManagementObject)()
From i In o.GetRelated("Win32_LogicalDisk").Cast(Of ManagementObject)()
SelectString.Format("{0}\", i("Name"))
Return usbDrivesLetters.ToList()
EndFunction
Nota: Debes añadir importación de los espacios de nombres: System System.Collections.Generic System.IO System.Linq System.Management (de NuGet)
Código de ejemplo usar estas los métodos de USBUtil.
classProgram
{
staticvoid Main(string[] args)
{
Console.Title = "Ejemplo de Visual C# usando .NET 5.0 (net5.0-windows) y System.Management Version=5.0.0";
Console.WriteLine("Mostrar las unidades usando DriveInfo.GetDrives().");
foreach (var dr in DriveInfo.GetDrives())
Console.WriteLine("Unidad: {0}, tipo: {1}", dr.Name, dr.DriveType);
Console.WriteLine();
Console.WriteLine("Mostrar las unidades extraíbles.");
var usb = USBUtil.GetUsbDriveLetters();
foreach (var s in usb)
Console.WriteLine("{0}", s);
Console.WriteLine();
Console.ReadKey();
}
ModuleProgramSub Main(args AsString())
Console.Title = "Ejemplo de Visual Basic usando .NET 5.0 (net5.0-windows) y System.Management Version=5.0.0"
Console.WriteLine("Mostrar las unidades usando DriveInfo.GetDrives().")
ForEach dr In DriveInfo.GetDrives()
Console.WriteLine("Unidad: {0}, tipo: {1}", dr.Name, dr.DriveType)
Next
Console.WriteLine()
Console.WriteLine("Mostrar las unidades extraíbles.")
Dim usb = USBUtil.GetUsbDriveLetters()
ForEach s In usb
Console.WriteLine("{0}", s)
Next
Console.WriteLine()
Console.ReadLine()
EndSubEndModule
Pues eso… a pesar de los pesares, hay algo bueno al crear los proyectos para Visual C# desde Visual Studio que en Visual Basic (por aquello de que debemos estar protegidos de tocar donde no se debe, o eso supongo). Es algo muy simple, que introdujeron (creo) en Visual Studio 2005 y es lo de que el método Sub Main sea autogenerado por el Visual Studio y no te permita crear uno propio… o al menos eso me ha pasado con Visual Studio 2022 Version 17.2.0 Preview 1.0 y al final he tenido que crear el proyecto con C# para poder poner lo que me dé la gana en el método Main. En fin…
Y es que, aunque haya definido mi propio método Sub Main, el Visual Studio me daba error de compilación de que ya estaba definido (o estaba definido más de una vez), no recuerdo bien qué me dijo… pero corté por lo sano, descarté el proyecto de Visual Basic y lo creé con C# (para .NET 6.0 y Windows Desktop). Ese proyecto solo se encarga de llamar a otro que es el principal y por tanto, lo que necesitaba hacer es poder llamar al formulario adecuado para que se iniciara ahí la aplicación (el que tengo definido en otro proyecto diferente al de inicio). Esto es para poder tener proyectos de inicio diferentes para cada «cliente» que quiera usar mi aplicación. Y en esos proyectos asignar los parámetros personalizados de cada cliente. Todo esto último, solo para aclarar. 😉
Buscaré en la documentación si hay alguna forma de «pasar» de esta automatización (que, seguro que la hay, desde el propio Visual Studio, ya que creando el proyecto desde la línea de comandos con dotnet seguro que se puede). Y si la hay ya te lo contaré.
Nota: Antes de publicar esto, he probado a crear un proyecto con dotnet: He creado el directorio con el nombre del proyecto, he cambiado a ese directorio y he escrito esto en la línea de comandos: dotnet new winforms -lang VB -f net6.0 Y el proyecto se ha creado con el fichero Program.vb (con la definición de Sub Main) y un formulario Form1. Y ahora no dice nada el Visual Studio si lo cargo. Creo que el truco está en no crear los directorios ni asignaciones a My Project, etc. Lo probaré desde Visual Studio a ver…
Nota 2: Para solucionar esto en un proyecto creado desde Visual Studio. He seguido estos pasos: He comentado (también las puedes borrar) las secciones (cada una está dentro de <ItemGroup>) : <Compile Update="My Project\Application.Designer.vb"> y <None Update="My Project\Application.myapp">.
He comentado <MyType>WindowsForms</MyType> en el ItemGroup principal y de paso he eliminado la carpeta My Project. Y el fichero ApplicationEvents.vb. Esto realmente es lo que da el problema de que haya dos Sub Main.
Y finalmente he creado un fichero Program.vb con el código «personalizado» para Sub Main. En fin… complicaciones por intentar facilitar las cosas a los que preferimos Visual Basic.
Figura 1. Para quitar el error debes comentar MyType.
Nota 3: Aunque los proyectos de C# creados con Visual Studio también tienen código autogenerado… por ejemplo: ApplicationConfiguration.Initialize. Que lo que hace es lo que siempre (o casi) han hecho los métodos Main de las aplicaciones de Windows Forms: public static void Initialize() { Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); Application.SetHighDpiMode(HighDpiMode.SystemAware); }
Pues eso… ¡peasso de título! y seguramente se me olvidará algo, por eso he puesto al final «y más». Pero la idea que tengo en mente hoy 24 de febrero de 2022 (con la guerra de Ucrania fresquita, aunque es algo que, lamentablemente no es tan fresca y que ya viene de largo), es explicarte en una serie de posts o entradas en el blog todo lo indicado en el título.
Sobre las expresiones lambda o métodos anónimos, he pensado en ponerte un par de videos que Héctor de León publicó a principios del año pasado en su canal de YouTube (HDELEON.NET), pero como el código que él utiliza es para C# .NET, te mostraré también el equivalente para VB.NET así, si eres de los que utilizan C# lo puedas entender mejor. Todo esto contando con que él me autorice mostrar su código de C# y el equivalente (en la medida de lo posible) de Visual Basic para punto NET. Actualización de las 17:33: Autorización que ya me ha dado 😉 ¡Gracias Héctor!
En cuanto a la programación asíncrona, te explicaré cómo crear tareas en otros hilos (principalmente con Task.Run) y el uso de async y await. Esas tareas se lanzarán o se procesarán también en el hilo principal de una aplicación de tipo Windows Forms (todo el código creado para .NET Core versiones 5 y/o 6) de forma que sepas qué cosas debes saber para el uso de controles, etc. entre hilos, cosa que solucionaré con InvokeRequired y la llamada a un delegado mediante Invoke. Por supuesto verás cómo definir delegados y cómo usarlos en el código. Con todo esto verás cómo acceder a parte del código que se ejecuta en el hilo principal (el creado para mostrar el formulario de inicio) desde otro hilo (o tarea).
También verás cómo cancelar esas tareas y cómo controlarlas, todo ellos mediante el uso de objetos CancellationTokenSource y CancellationToken (tanto en su forma normal y anulable). Y lo que debes hacer para comprobar en el código cuando se ha cancelado y cómo tratar esa cancelación, algo que harás pasándole a la tarea (Task) el objeto de tipo CancellationToken.
Y como algunas de las tareas (ya sean asíncronas o no) puede que tenga que acceder a objetos de una colección, verás algunos casos de cómo usar Parallel.For para repartir en tareas el proceso de comprobación del contenido de esa colección.
La mayoría de las cosas que se hará en el código de ejemplo requerirá de las expresiones lambda (o métodos anónimos) y su uso en expresiones de LINQ. Ya sabes: Where, Any, Select, etc.
Por último, parte del código de ejemplo lo haré usando un control DataGridView y en ese caso te mostraré cómo crearlo para usar una caché con los datos que manejará y todo ello usando el modo virtual de ese control, de esa forma, al menos en mi caso, he logrado agilizar (sobre todo acelerar) mostrar los datos en ese grid (o cuadrícula). La caché usada estará preparada para el tipo de datos que voy a usar en ese ejemplo.
Todo esto, lo iré publicando poco a poco, entre otras cosas, porque lo estoy usando en una aplicación que utiliza datos o tipos muy concretos. Si te sirve de algo, es una aplicación que estoy migrando de MS-DOS a Windows, y la mayoría de los datos los obtiene de ficheros de texto… ¡Sí, así de vieja es! 🙂 Pero haré que el código acceda a colecciones de datos más simples, que en principio no se obtendrá de una base de datos, pero no descarto que también haga alguna modificación para acceder a una base de datos, y si es remota, mejor. Pero eso ya lo veré en su momento.
Bueno, te dejo por ahora y ya iré poniendo cosas… seguramente pondré los enlaces en este mismo post, pero si se me olvida hacerlo… pues… ¡busca en fechas posteriores al 24 de febrero de 2022! 😉
Y ya sabes… si me quieres invitar a un cafelillo o refresco virtual, puedes usar el enlace de DONAR con PayPal. Gracias de antemano.
Pues eso… para descargar ficheros de un sitio Web, hasta hoy usaba el método DownloadFile de la clase WebClient, pero ya estaba un poco harto del «warning» de que esa clase (y otras) estaban obsoletas y que era recomendable usar HttpClient, pero… no daba con un ejemplo (de código) práctico y, porque no, sencillo. Mire en varios sitios y de una forma u otra, se complicaba la cosa… hasta que me dio por mirar el contenido de la clase HttpClient en la documentación de .NET (esto me pasa por no fiarme de los ejemplos de la documentación de MS :-P).
Y aquí te muestro lo que he hecho, creo que de forma simple.
El código que te voy a mostrar descarga un fichero de un sitio Web y lo guarda de forma local. Como para este ejemplo he usado un fichero de texto (txt) que tengo alojado en mi sitio (www.elguille.info), en el código de ejemplo hago que se muestre con el Notepad, pero si lo que te descargas es otro tipo de fichero, ya sea una imagen, etc. tendrás que cambiar el código usado en «Process.Start«.
Este código usa async/await para la descarga y para guardarlo localmente. Pero resulta que Visual Basic no permite usar Async en el método Main (C# tampoco, al menos en las versiones anteriores a la 7.1), por tanto, el código de VB.NET es algo diferente al de C# (aparte de los puntos y comas), básicamente porque en VB el método Main no puede ser asíncrono, así que lo he solucionado haciendo una llamada a otro método desde Main y ese otro método si es asíncrono. Este mismo paso intermedio tendrás que hacerlo si usas una versión de C# que no soporte que Main sea un método de tipo Task asíncrono. En realidad, tendrías que hacer otros cambios en el código de C#, ya que uso nuevas cosas que tampoco estaban en las versiones anteriores…
Básicamente lo que hace el código es crear una instancia «estática/compartida» de un nuevo objeto del tipo HttpClient y después usarlo en el código. Esto en este ejemplo concreto no es necesario, ya que una vez que se utilice ese objeto el programa prácticamente finaliza, pero… es lo que recomiendan: que solo se use una instancia en la aplicación.
Para la descarga, utilizo el método GetByteArrayAsync al que se le indica la dirección URL donde está el fichero en cuestión (o una página WEB si esa es la idea, la de descargar una página Web), ese método devuelve un array de tipo Byte, que usaremos para guardarlo en el fichero local, esto se consigue con WriteAsync de la clase FileStream, en cuyo constructor, entre otras cosas, indicaremos el path local.
El que haya usado GetByteArrayAsync es porque mi código original no descarga un contenido «normal» de tipo cadena, pero para el caso, también sirve. Y de esta forma podrás usar el método que he definido para esta tarea de descargar/guardar (DownloadFileAsync) para cualquier tipo de contenido.
Y ya, no me enrollo más y te muestro el código.
Nota: Aunque sea más código, te muestro TODO el código, incluyendo las importaciones, etc.
El código de ejemplo para Visual Basic.NET
'--------------------------------------------------------------------------------' Descargar un fichero de un sitio web usando HttpClient (10/Feb/22 19.05)'' Ejemplo basado en:' https://docs.microsoft.com/en-us/dotnet/api/system.net.http.httpclient'' (c) Guillermo Som (Guille), 2022'--------------------------------------------------------------------------------Imports System
Imports System.Diagnostics
Imports System.Threading.Tasks
ModuleProgram'''<summary>''' El objeto HttpClient se recomiendo instanciarlo solo 1 vez en la aplicación.'''</summary>PrivateReadOnly ClienteHttp AsNew System.Net.Http.HttpClient()
Sub Main(args AsString())
'Console.WriteLine("Hello World!")' Como en VB no se puede esperar en Main,' hacer el trabajo asíncrono en otro método y esperar a que se termine todo...
descargar()
Console.ReadLine()
EndSubPrivateAsyncSub descargar()
Dim ficWeb = "https://www.elguille.info/pruebaGuille.txt"Dim ficLocal = "prueba.txt"Console.WriteLine("Descargando {0}...", ficWeb)
Dim res = Await DownloadFileAsync(ficWeb, ficLocal)
If res ThenConsole.WriteLine("Descarga completada.")
' Mostrar el contenido del fichero local.Process.Start("notepad", ficLocal)
EndIfConsole.WriteLine()
Console.WriteLine("Pulsa INTRO para finalizar.")
EndSub'''<summary>''' Descarga el fichero indicado (url) y lo guarda en el fichero destino (usando HttpClient).'''</summary>'''<param name="ficWeb">El fichero a descargar (de una dirección URL).</param>'''<param name="ficDest">El fichero de destino, donde se guardará el descargado.</param>'''<returns>True o false según haya tenido éxito la descarga o no.</returns>PublicAsyncFunction DownloadFileAsync(ficWeb AsString, ficDest AsString) AsTask(OfBoolean)
Try' Simplificando la descarga.Dim contenido = Await ClienteHttp.GetByteArrayAsync(ficWeb)
' Si se ha podido descargar.If contenido IsNotNothingAndAlso contenido.Length > 0 Then' Guardarlo en el fichero de destino.' Si el fichero destino existe, se sobreescribe.Using fs AsNew System.IO.FileStream(ficDest, System.IO.FileMode.Create,
System.IO.FileAccess.Write,
System.IO.FileShare.None)
Await fs.WriteAsync(contenido.AsMemory(0, contenido.Length))
EndUsingElseConsole.WriteLine("No se ha podido descargar.")
ReturnFalseEndIfCatch ex AsException' Se ha producido un error al descargar o guardar.Console.WriteLine("Error: {0}", ex.Message)
ReturnFalseEndTryReturnTrueEndFunctionEndModule
El código de ejemplo para C#
//--------------------------------------------------------------------------------// Descargar un fichero de un sitio web usando HttpClient (10/Feb/22 19.25)//// Ejemplo basado en:// https://docs.microsoft.com/en-us/dotnet/api/system.net.http.httpclient//// (c) Guillermo Som (Guille), 2022//--------------------------------------------------------------------------------using System;
using System.Diagnostics;
using System.Threading.Tasks;
namespace Descargar_Fichero_con_HttpClient_CS
{
classProgram
{
///<summary>/// El objeto HttpClient se recomiendo instanciarlo solo 1 vez en la aplicación.///</summary>privatereadonlystatic System.Net.Http.HttpClient ClienteHttp = new();
// En C# 7.1 y superior se puede usar Main como Task y async.staticasyncTask Main(string[] args)
{
//Console.WriteLine("Hello World!");var ficWeb = "https://www.elguille.info/pruebaGuille.txt";
var ficLocal = "prueba.txt";
Console.WriteLine("Descargando {0}...", ficWeb);
var res = await DownloadFileAsync(ficWeb, ficLocal);
if (res)
{
Console.WriteLine("Descarga completada.");
// Mostrar el contenido del fichero local.Process.Start("notepad", ficLocal);
}
Console.WriteLine();
Console.WriteLine("Pulsa INTRO para finalizar.");
// Las versiones de C# anteriores a 7.1 no pueden esperar en Main,// por tanto, el código anterior ponerlo en un método y llamarlo desde aquí// y esperar a que se termine todo...//descargar();Console.ReadLine();
}
///<summary>/// Descarga el fichero indicado (url) y lo guarda en el fichero destino (usando HttpClient).///</summary>///<paramname="ficWeb">El fichero a descargar (de una dirección URL).</param>///<paramname="ficDest">El fichero de destino, donde se guardará el descargado.</param>///<returns>True o false según haya tenido éxito la descarga o no.</returns>publicasyncstaticTask<bool> DownloadFileAsync(string ficWeb, string ficDest)
{
try
{
// Simplificando la descarga.var contenido = await ClienteHttp.GetByteArrayAsync(ficWeb);
// Si se ha podido descargar.if (contenido != null && contenido.Length > 0)
{
// Guardarlo en el fichero de destino.// Si el fichero destino existe, se sobreescribe.using System.IO.FileStream fs = new(ficDest, System.IO.FileMode.Create,
System.IO.FileAccess.Write,
System.IO.FileShare.None);
await fs.WriteAsync(contenido.AsMemory(0, contenido.Length));
}
else
{
Console.WriteLine("No se ha podido descargar.");
returnfalse;
}
}
catch (Exception ex)
{
// Se ha producido un error al descargar o guardar.Console.WriteLine("Error: {0}", ex.Message);
returnfalse;
}
returntrue;
}
}
}
Y esto es todo… recuerda pulsar en el botoncito ese de PayPal si así lo crees conveniente 😉
Nos vemos. Guillermo
P.S. El código lo puedes ver/descargar del repositorio de GitHub que he creado para este caso.
Pues eso… viendo las novedades de C# 10.0 me he topado con los detalles de la «novedad» Global using directives, dicho de esa forma parece algo «WOW!», y… es algo que siempre he querido que quitasen de forma predeterminada al crear un nuevo proyecto de Visual Basic para .NET: que haya importaciones implícitas de espacios de nombres al crear un nuevo proyecto.
Y eso es lo que es esa «nueva» característica de C# 10.0, crear definiciones «using» (ya que «Imports» es cosa de Visual Basic para .NET) de los espacios de nombres más habituales según el tipo de proyecto creado.
Que sí, que está muy bien, pero a mí nunca me ha gustado, de hecho, en la mayoría de los proyectos que creaba (sobre todo si era para compartirlo como parte de algún artículo), lo quitaba, con idea de así tener que escribir las importaciones de espacios de nombres en cada fichero (de código) de ese proyecto. Porque es la única forma de saber «a ciencia cierta» qué espacios de nombres se estaban usando en ese fichero de código.
Para que nos entendamos, a diferencia de C#, en Visual Basic el espacio de nombres System.Text nunca se importa de forma predeterminada, algo que sí ocurre en los proyectos de C#; por tanto, si quiero crear un nuevo objeto del tipo StringBuilder, o bien lo creo usando el nombre «completo» de la clase StringBuilder: System.Text.StringBuilder o bien declaro la importación del espacio de nombres System.Text y ya el compilador sabrá que StringBuilder está accesible (al revisar las clases contenidas en cada uno de los espacios de nombres que estén incluidos en las importaciones).
¡Eh! que no es una crítica, que me parece muy bien, y si ahora los del TEAM de C# lo están añadiendo como algo «predeterminado» será porque tampoco será tan malo, lo único que digo es que sigue siendo lo mismo que teníamos los «desarrollado-res» de Visual Basic desde hace ya casi 20 años… ¡NOVEDAD! WOW! 😉
Total, a lo que iba, que ya no hace falta seguir dando nuevas características a Visual Basic, porque al final C# será como era Visual Basic hace 20 años… eso sí, con (entre otras cosas) acabando la línea con un punto y coma.
Pero preferiría que Visual Basic evolucionara con las «nuevas características» realmente nuevas, para que a los que no nos gusta usar punto y coma para indicar que una instrucción ha finalizado o poner cosas entre llaves, etc., etc., y dejar de ver cómo C# evoluciona para hacer cosas que desde «siempre» ha hecho Visual Basic y, casi seguro, que era criticado por eso… Y si no me crees, échale un vistazo a las declaraciones sin tipos de variables (que, siempre al estilo de C#) en C# también lo añadieron en su día como novedad novedosa…
Pues eso, que desde que cambié el alojamiento de «mi sitio», elguille.info, de Axarnet/Domitienda a acens (de telefónica) los enlaces que tenía «incrustados» en las páginas (para que mostrase en una página de mi sitio el artículo de mi blog (este) no se mostraban a causa de un error que mostraba este texto: The request was aborted: Could not create SSL/TLS secure channel La solución ha sido fácil (después de haber buscado en la red sobre este error) y que he he econtrado en StackOverflow, concretamente en un comentario a una de las respuestas, no puedo poner el enlace a ese comentario, pero es el que tiene este texto: You don’t need to exclusively set it to a single type, you can simply append as well. System.Net.ServicePointManager.SecurityProtocol |= System.Net.SecurityProtocolType.Tls12; – Nae Mar 20 ’18 at 8:44
Ese código es para C#, en Visual Basic sería este:
System.Net.ServicePointManager.SecurityProtocol =
System.Net.ServicePointManager.SecurityProtocol Or System.Net.SecurityProtocolType.Tls12
Lo que tengo que hacer ahora es ver si ese código simplemente lo puedo poner en la página maestra o tendré que ponerlo en cada página… creo que si se ejecuta una sola vez es suficiente, así que… si ves que da nuevamente ese error, te ruego que me lo digas. Gracias.