Dreamine.PLC.Mitsubishi.MxComponent.Internal.DefaultComObjectFactory에 대한 상속 다이어그램 :

Dreamine.PLC.Mitsubishi.MxComponent.Internal.DefaultComObjectFactory에 대한 협력 다이어그램:

Public 멤버 함수
object	Create (string progId)

정적 Private 멤버 함수
static object	CreateDotUtlType64Wrapper ()
static ? string	FindDotUtlType64AssemblyPath ()
static InvalidOperationException	CreateFriendlyException (string progId, Exception? innerException=null)

상세한 설명

설치된 COM 개체를 ProgID로 생성합니다.

DefaultComObjectFactory.cs 파일의 13 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ Create()

object Dreamine.PLC.Mitsubishi.MxComponent.Internal.DefaultComObjectFactory.Create ( string progId )

inline

지정한 ProgID에서 MX Component COM 개체를 생성합니다.

매개변수

progId 생성할 COM 클래스의 ProgID입니다. 64비트 프로세스에서는 32비트 기본 ProgID가 64비트 래퍼로 치환됩니다.

반환값: 생성된 후기 바인딩 COM 개체입니다.

예외

PlatformNotSupportedException	Windows가 아닌 플랫폼에서 호출할 때 발생합니다.
ArgumentException	progId 가 비어 있거나 공백일 때 발생합니다.
InvalidOperationException	COM 클래스가 등록되지 않았거나 래퍼 어셈블리 또는 형식을 찾을 수 없거나 개체를 생성할 수 없을 때 발생합니다.

Dreamine.PLC.Mitsubishi.MxComponent.Internal.IComObjectFactory를 구현.

DefaultComObjectFactory.cs 파일의 63 번째 라인에서 정의되었습니다.

    {
        if (!OperatingSystem.IsWindows())
        {
            throw new PlatformNotSupportedException("MX Component COM controls are supported on Windows only.");
        }
 
        if (string.IsNullOrWhiteSpace(progId))
        {
            throw new ArgumentException("COM ProgID must not be empty.", nameof(progId));
        }
 
        if (Environment.Is64BitProcess && progId.Equals("ActUtlType.ActUtlType", StringComparison.OrdinalIgnoreCase))
        {
            progId = "ActUtlType64.ActUtlWrap";
        }
 
        if (Environment.Is64BitProcess && progId.StartsWith("ActUtlType64.", StringComparison.OrdinalIgnoreCase))
        {
            return CreateDotUtlType64Wrapper();
        }
 
        Type? type;
        try
        {
            type = Type.GetTypeFromProgID(progId, throwOnError: false);
        }
        catch (Exception ex)
        {
            throw CreateFriendlyException(progId, ex);
        }
 
        if (type is null)
        {
            throw CreateFriendlyException(progId);
        }
 
        try
        {
            return Activator.CreateInstance(type)
                ?? throw new InvalidOperationException($"Failed to create MX Component COM object: {progId}");
        }
        catch (Exception ex)
        {
            throw CreateFriendlyException(progId, ex);
        }
    }

다음을 참조함 : CreateDotUtlType64Wrapper(), CreateFriendlyException().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ CreateDotUtlType64Wrapper()

object Dreamine.PLC.Mitsubishi.MxComponent.Internal.DefaultComObjectFactory.CreateDotUtlType64Wrapper ( )

inlinestaticprivate

설치된 DotUtlType64 래퍼 어셈블리에서 64비트 MX Component 개체를 생성합니다.

반환값: 생성된 DotUtlType64 래퍼 개체입니다.

예외

InvalidOperationException	래퍼 어셈블리나 형식을 찾을 수 없거나 인스턴스를 생성할 수 없을 때 발생합니다.
FileLoadException	래퍼 어셈블리를 로드할 수 없을 때 발생할 수 있습니다.
BadImageFormatException	래퍼 어셈블리 형식이나 프로세스 비트 수가 호환되지 않을 때 발생할 수 있습니다.

DefaultComObjectFactory.cs 파일의 151 번째 라인에서 정의되었습니다.

    {
        var assemblyPath = FindDotUtlType64AssemblyPath();
        if (assemblyPath is null)
        {
            throw new InvalidOperationException(
                "MX Component 64-bit wrapper assembly was not found. Expected DotUtlType64.dll under the MELSOFT ACT Control Wrapper folder.");
        }
 
        var assembly = Assembly.LoadFrom(assemblyPath);
        var type = assembly.GetType("DotUtlType64.DotUtlType64", throwOnError: false)
            ?? throw new InvalidOperationException($"DotUtlType64.DotUtlType64 type was not found in {assemblyPath}.");
 
        return Activator.CreateInstance(type)
            ?? throw new InvalidOperationException($"Failed to create DotUtlType64.DotUtlType64 from {assemblyPath}.");
    }

다음을 참조함 : FindDotUtlType64AssemblyPath().

다음에 의해서 참조됨 : Create().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ CreateFriendlyException()

InvalidOperationException Dreamine.PLC.Mitsubishi.MxComponent.Internal.DefaultComObjectFactory.CreateFriendlyException	(	string	progId,
		Exception?	innerException = null )

inlinestaticprivate

COM 등록 또는 생성 실패를 프로세스 비트 수 안내가 포함된 예외로 변환합니다.

매개변수

progId	생성에 실패한 COM ProgID입니다.
innerException	원래 발생한 예외이며 없으면 `null`입니다.

반환값: 진단 안내와 원본 예외를 포함한 예외입니다.

DefaultComObjectFactory.cs 파일의 238 번째 라인에서 정의되었습니다.

    {
        var bitness = Environment.Is64BitProcess ? "x64" : "x86";
        return new InvalidOperationException(
            $"MX Component COM '{progId}' is not registered for the current {bitness} process. " +
            "For a 64-bit process, try ProgID 'ActUtlType64.ActUtlWrap'. For a 32-bit process, try 'ActUtlType.ActUtlType'. " +
            "Check MX Component Communication Setup Utility and confirm the Logical Station Number.",
            innerException);
    }

다음에 의해서 참조됨 : Create().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ FindDotUtlType64AssemblyPath()

? string Dreamine.PLC.Mitsubishi.MxComponent.Internal.DefaultComObjectFactory.FindDotUtlType64AssemblyPath ( )

inlinestaticprivate

일반적인 MELSOFT 설치 경로에서 DotUtlType64 래퍼 어셈블리를 찾습니다.

반환값: 처음 발견된 어셈블리 경로이며 파일이 없으면 null입니다.

DefaultComObjectFactory.cs 파일의 184 번째 라인에서 정의되었습니다.

    {
        var candidates = new[]
        {
            Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.ProgramFilesX86),
                "MELSOFT",
                "ACT",
                "Control",
                "Wrapper",
                "DotUtlType64.dll"),
            Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.ProgramFilesX86),
                "MELSOFT",
                "ACT",
                "Control",
                "DotUtlType64.dll")
        };
 
        return candidates.FirstOrDefault(File.Exists);
    }

다음에 의해서 참조됨 : CreateDotUtlType64Wrapper().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

DefaultComObjectFactory.cs

Public 멤버 함수

정적 Private 멤버 함수

상세한 설명

멤버 함수 문서화

◆ Create()

◆ CreateDotUtlType64Wrapper()

◆ CreateFriendlyException()

◆ FindDotUtlType64AssemblyPath()