IFileTypeManager.GetConverterToDefaultBilingual Method (String, String, EventHandler(MessageEventArgs))

IFileTypeManagerGetConverterToDefaultBilingual Method (String, String, EventHandlerMessageEventArgs)

Creates and initializes a file converter in order to read a single (typically bilingual) input file and write a bilingual output file in the default format.

The converter will automatically use the file type that best matches the file to be converted.

The file type definitions are each tested in sequence, and the first file type definition that matches the input file is used. The following steps are used to determine if a file type definition matches:

The regular expression is evaluated against the name of the file to be converted. If it does not match, the file type definition is not used.
If a file sniffer is defined for the file type definition, it is applied to the file. If the file sniffer does not indicate that the file is supported, the file type definition is not used.

If no matching file type definition is found, a OneOrMoreFilesNotSupportedException is thrown.

Namespace: Sdl.FileTypeSupport.Framework.IntegrationApi
Assembly: Sdl.FileTypeSupport.Framework.Core (in Sdl.FileTypeSupport.Framework.Core.dll) Version: 1.0.0.0 (1.0.2343.0)

Syntax

C++

Copy

IMultiFileConverter GetConverterToDefaultBilingual(
	string bilingualInputFilePath,
	string bilingualOutputFilePath,
	EventHandler<MessageEventArgs> messageHandler
)

Function GetConverterToDefaultBilingual ( 
	bilingualInputFilePath As String,
	bilingualOutputFilePath As String,
	messageHandler As EventHandler(Of MessageEventArgs)
) As IMultiFileConverter

IMultiFileConverter^ GetConverterToDefaultBilingual(
	String^ bilingualInputFilePath, 
	String^ bilingualOutputFilePath, 
	EventHandler<MessageEventArgs^>^ messageHandler
)

abstract GetConverterToDefaultBilingual : 
        bilingualInputFilePath : string * 
        bilingualOutputFilePath : string * 
        messageHandler : EventHandler<MessageEventArgs> -> IMultiFileConverter

Parameters

bilingualInputFilePath: Type: SystemString
The native files to be converted
bilingualOutputFilePath: Type: SystemString
Full path to the bilingual file to be created
messageHandler: Type: SystemEventHandlerMessageEventArgs
(optional) A message handler implementation that will receive any messages reported from file sniffers invoked in the process. If a converter is returned, this message handler will also be connected to the Message event on the converter. You may specify null for this parameter.

Return Value

Type: IMultiFileConverter
A file converter object initialized to read the file, based on information from the best matching file type definition that will create an output file in the default bilingual format with the specified name. To use the file converter, add your own bilingual processors to the converter and call Parse or ParseNext.

Exceptions

Exception	Condition
OneOrMoreFilesNotSupportedException	Thrown if no file type definition in the file type manager can be used.

Remarks

To convert bilingual files to native you would typically use GetConverterToNative(String, OutputPropertiesProvider, EventHandlerMessageEventArgs).

Reference

IFileTypeManager Interface

GetConverterToDefaultBilingual Overload

Sdl.FileTypeSupport.Framework.IntegrationApi Namespace

Community

Edit

Be the first to Edit the community content of this topic.

Comments

Send comments on this topic to sdk-feedback@sdl.com