# Funciones de interoperabilidad .NET Extienden el lenguaje con ensamblados y objetos de .NET. Una extensión nueva se compila para `net10.0` o para .NET Standard 2.0: vea [Extensiones .NET](/es/devkron/2.0/instalacion/extensiones-net.md). Una introducción con casos de uso está en [Temas avanzados](/es/devkron/2.0/lenguaje/imperativo/temas-avanzados.md). | Función | Descripción | |---|---| | `_import_library(ensamblado)` | Carga un ensamblado y devuelve una referencia a él. | | `_new([ensamblado,] tipo [, args…])` | Crea una instancia de una clase y devuelve una referencia. | | `_gettype([ensamblado,] tipo)` | Devuelve una referencia al `System.Type` del tipo. | | `_map_function(ensamblado, tipo, método, función, argumentos, retorno)` | Registra un método como función de DKL. | | `_invoke(objeto, función [, args…])` | Llama a un método de instancia mapeado. | | `_get(objeto, propiedad)` | Lee una propiedad. | | `_set(objeto, propiedad, valor)` | Escribe una propiedad. | ## _import_library `_import_library(ensamblado)`: carga un ensamblado .NET y devuelve una referencia que usan las demás funciones. Debe asignarse con `ref`. - `ensamblado` es un nombre de archivo (`"MiExtension.dll"`, con o sin ruta) o un nombre calificado (con `PublicKeyToken`). - Sin ruta, se busca junto al ejecutable `dkl`. - Los tipos básicos de la plataforma (`System.Math`, `System.Text.StringBuilder`, `System.IO.StringReader`, `System.Enum`…) ya están cargados y se usan con `-1` o sin ensamblado. Otros, como los de XML (`System.Xml.XmlReaderSettings`), están en un ensamblado que no se carga solo: impórtelo por su nombre calificado y pase la referencia a `_new`, `_gettype` y `_map_function`. Si no, `_new` falla con `No se pudo encontrar el tipo:System.Xml.XmlReaderSettings`. - Reemplazar una DLL ya cargada requiere reiniciar el servidor FastCGI. ```dkl ref asm = _import_library("System.Text.RegularExpressions.dll") ref @xml_asm = _import_library("System.Private.Xml, Version=10.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51") ``` Las funciones de DKL no ven las variables del programa: si una función usa el ensamblado, guárdelo en una global (`ref @xml_asm`), como en el ejemplo. ## _new `_new(tipo)`, `_new(tipo, args…)`, `_new(ensamblado, tipo)` o `_new(ensamblado, tipo, args…)`: crea una instancia y devuelve una referencia. Debe asignarse con `ref` (si no: `No se puede alojar una referencia de objeto sin una sentencia 'ref'`). - `tipo`: nombre completo de la clase (`"System.Text.StringBuilder"`). - `ensamblado`: referencia de `_import_library`; si se omite (o es `-1`), el tipo se busca en los ensamblados que el motor ya tiene cargados. - `args`: argumentos del constructor. En 2.0 se pasan **todos** (1.x omitía el último). ## _gettype `_gettype(tipo)` o `_gettype(ensamblado, tipo)`: devuelve una referencia al `System.Type`. Útil para consultar el tipo o para pasarlo a métodos que lo piden. ## _map_function `_map_function(ensamblado, tipo, método, función, argumentos, retorno)`: registra el método `método` de la clase `tipo` con el nombre `función` de DKL. | Parámetro | Valor | |---|---| | `ensamblado` | referencia de `_import_library`, o `-1` para los ensamblados ya cargados | | `tipo` | nombre completo de la clase | | `método` | nombre del método (estático o de instancia) | | `función` | nombre con que se llamará desde DKL (`"re.coincide"`) | | `argumentos` | tipos .NET de la firma, separados por comas (`"System.String,System.String"`), para elegir la sobrecarga. Un argumento que es un objeto lleva `*` antes del tipo (`"*System.Type,System.String"`). Si el método no tiene argumentos, `"void"` | | `retorno` | `"$"` cadena, `"#"` número, `"*"` objeto (se devuelve como referencia), `"void"` nada | - Un método **estático** mapeado se llama como cualquier función: `re.coincide(texto, patrón)`. - Un método **de instancia** se llama con `_invoke`. - **Argumentos que son objetos:** marque su tipo con `*`. Sin `*`, DKL pasa el número con que identifica a la referencia y el método falla, por ejemplo con `Invalid cast from 'System.Decimal' to 'System.Type'`. - **Métodos sin argumentos:** use `"void"` como firma. Con `""`, un método de instancia llamado con `_invoke` falla con `Object reference not set to an instance of an object`; un método estático funciona con las dos, pero `"void"` sirve en ambos casos. - `"void"` vale tanto en la firma (sin argumentos) como en el retorno (no devuelve nada). - Los argumentos se convierten a los tipos .NET de la firma con la cultura invariante. - En 2.0, la función mapeada se encuentra también por `namespace`, `alias` o `using`. ## _invoke `_invoke(objeto, función [, args…])`: llama al método de instancia mapeado con el nombre `función` sobre `objeto`. Si `función` no se mapeó: `El método que está intentando invocar con el alias '…' no está en el mapa de funciones, use _map_function`. ## _get `_get(objeto, propiedad)`: devuelve el valor de una propiedad. Un prefijo en el nombre indica cómo tratar el resultado: | Prefijo | Resultado | |---|---| | (ninguno) | el tipo que mejor corresponda (número, cadena u objeto) | | `$` | cadena | | `#` | número | | `&` | objeto (asígnelo con `ref`) | ## _set `_set(objeto, propiedad, valor)`: asigna una propiedad. Si el nombre termina en `*`, `valor` es una referencia a otro objeto. El valor debe ser del tipo exacto de la propiedad: asignar un número a una propiedad `Int32` da `Object of type 'System.Decimal' cannot be converted to type 'System.Int32'`; para esos casos mapee un método o use propiedades de tipo cadena. ### Propiedades de tipo enumeración `_set` no convierte un texto ni un número al valor de una enumeración: `_set(conf, "ValidationType", "Schema")` da `Object of type 'System.String' cannot be converted to type 'System.Xml.ValidationType'`. Obtenga el valor con `System.Enum.Parse` (mapeado con firma `"*System.Type,System.String"` y retorno `"*"`) y asígnelo como referencia, con `*` al final del nombre de la propiedad: ```dkl do _map_function(-1, "System.Enum", "Parse", "enum.parse", "*System.Type,System.String", "*") ref conf = _new(@xml_asm, "System.Xml.XmlReaderSettings") ref modo = enum.parse(_gettype(@xml_asm, "System.Xml.ValidationType"), "Schema") do _set(conf, "ValidationType*", modo) ``` ## Ejemplo completo ```dkl ref sb = _new("System.Text.StringBuilder") do _map_function(-1, "System.Text.StringBuilder", "Append", "sb.append", "System.String", "$") do _map_function(-1, "System.Text.StringBuilder", "ToString", "sb.tostring", "void", "$") do _invoke(sb, "sb.append", "hola ") do _invoke(sb, "sb.append", "net") s = _invoke(sb, "sb.tostring") do print(s) do print(_get(sb, "Length")) do _map_function(-1, "System.Math", "Max", "net.max", "System.Decimal, System.Decimal", "#") do print(net.max(3, 9.5)) ref t = _gettype("System.Text.StringBuilder") do print(_get(t, "FullName")) ref ub = _new("System.UriBuilder") do _set(ub, "Host", "ejemplo.com") do _set(ub, "Scheme", "https") do print(_get(ub, "$Uri")) ref asm = _import_library("System.Text.RegularExpressions.dll") ref rx = _new(asm, "System.Text.RegularExpressions.Regex", "[0-9]+") do _map_function(asm, "System.Text.RegularExpressions.Regex", "Match", "re.primera", "System.String", "*") ref m = _invoke(rx, "re.primera", "folio A-2026-77") do print(_get(m, "Value")) ``` ```text hola net 8 9.5 System.Text.StringBuilder https://ejemplo.com/ 2026 ``` ## Ejemplo: validar un XML contra un esquema XSD DKL produce XML, pero no lo valida contra un esquema al producirlo. Para validarlo se usan las clases de XML de la plataforma. El ejemplo reúne lo anterior: ensamblado importado, argumentos que son objetos (`*`), métodos sin argumentos (`"void"`), una propiedad de tipo enumeración y el bloque `exception` al final de la función. `pedido.xsd`: ```xml ``` ```dkl #include "dkli.dkh" #! program "valida-xsd" { #include "functions.dkh" ref @xml_asm = _import_library("System.Private.Xml, Version=10.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51") do _map_function(-1, "System.Enum", "Parse", "enum.parse", "*System.Type,System.String", "*") do _map_function(@xml_asm, "System.Xml.Schema.XmlSchemaSet", "Add", "xsd.add", "System.String,System.String", "*") do _map_function(@xml_asm, "System.Xml.XmlReader", "Create", "xml.reader", "*System.IO.TextReader,*System.Xml.XmlReaderSettings", "*") do _map_function(@xml_asm, "System.Xml.XmlReader", "Read", "xml.read", "void", "#") do _map_function(@xml_asm, "System.Xml.XmlReader", "Close", "xml.close", "void", "void") valida::xml, esquema { ref conf = _new(@xml_asm, "System.Xml.XmlReaderSettings") ref tipo = _gettype(@xml_asm, "System.Xml.ValidationType") ref modo = enum.parse(tipo, "Schema") do _set(conf, "ValidationType*", modo) ref esquemas = _get(conf, "&Schemas") do _invoke(esquemas, "xsd.add", "", esquema) ref texto = _new("System.IO.StringReader", xml) ref lector = xml.reader(texto, conf) while _invoke(lector, "xml.read") { } do _invoke(lector, "xml.close") return "" exception { return last_error() } } do print("bien: [" + valida("Ana12.5", "pedido.xsd") + "]") do print("mal: [" + valida("Anadoce", "pedido.xsd") + "]") } ``` ```text bien: [] mal: [{1} Error en 'xml.read. (The 'total' element is invalid - The value 'doce' is invalid according to its datatype 'http://www.w3.org/2001/XMLSchema:decimal' - The string 'doce' is not a valid Decimal value.Exception has been thrown by the target of an invocation.) [valida-xsd.dkl][Ln= 22]] ``` - `valida` devuelve `""` si el XML cumple el esquema, o el mensaje del primer error. - La ruta del esquema relativa se resuelve contra la carpeta de trabajo del proceso; en un servidor, use una ruta completa. - Para validar lo que produce un [dialecto propio](/es/devkron/2.0/lenguaje/declarativo/directivas.md), obtenga primero el XML con `runscript("archivo")`. ## Extensiones compiladas para 1.x Las DLL de extensión compiladas para Devkron 1.x funcionan sin recompilar en 2.0. Solo necesita recompilarse una extensión que use la API interna del motor y acceda a `ContextBlock.Variables` o `ContextBlock.GlobalVars` (ahora son `VariableTable`, con los mismos métodos). Las que solo exponen funciones para `_map_function` no se ven afectadas.