Tokens de nombres PDF heredados
THPDFNameObject.Value y las claves heredadas de diccionarios retienen los tokens de nombres PDF sin la barra inicial; los tokens del parser cargado ya pueden contener escapes #HH
El escritor heredado decodifica el token existente y luego codifica todos los bytes reservados, espacios en blanco, bytes de control y bytes UTF-8 no ASCII; los escapes existentes se canonizan sin doble escape
Por ejemplo, el token #41 denota A, mientras que #2341 denota el texto literal #41; codifique los bytes crudos recién escritos con _PDFNameEncode antes de almacenar un hash literal seguido de dos dígitos hexadecimales
Las secuencias hexadecimales inválidas como #GZ y un hash final permanecen como datos literales y se escapan como #23GZ y #23 durante la serialización
Los espacios iniciales y finales se preservan como #20, y el nombre vacío sigue siendo un nombre PDF vacío; los valores en arrays, diccionarios anidados y claves de diccionario usan las mismas reglas de serialización
Los nombres no son cadenas de texto PDF: el escritor preserva los bytes y no transcodifica la codificación fuente del llamador; use UTF8Encode al suministrar nombres Unicode recién escritos
Los diccionarios frescos del builder nativo de XFA usan claves decodificadas mientras los valores de nombre siguen basados en tokens; los adapters deben codificar esas claves decodificadas una sola vez al moverlas al modelo de objetos heredado