مقدمه

Parse و TryParse از دید کارایی و حافظه یکی از ابزارهای مستقیم تبدیل متن در پلتفرم Microsoft .NET است. این API در حوزه‌هایی مانند مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای کاربرد دارد. هدف آن این است که نمایش متنی معتبر را به نوع مقصد تبدیل کند و در صورت نقض قرارداد، شکست را با استثنا اعلام نماید.

در این راهنما تحلیل سیستمی Parse و TryParse را از سطح پایه تا طراحی حرفه‌ای بررسی می‌کنیم. تفاوت اعتبار نحوی و اعتبار کسب‌وکار، رفتار مقدار null، اثر CultureInfo، مدیریت خطا، کارایی و انتخاب میان Parse و TryParse با مثال‌های کامل توضیح داده می‌شود.

اگر به نمای کلی خانواده تبدیل‌ها و مسیر یادگیری همه نوع‌ها نیاز دارید، راهنمای جامع متدهای Parse در C# و .NET را نیز مطالعه کنید. لینک‌های این مجموعه مستقل از دامنه ساخته شده‌اند تا پس از جابه‌جایی وب‌سایت هم سالم بمانند.

تصویر 1: Parse و TryParse از دید کارایی و حافظه؛ نمای مفهومی مسیر متن تا مقدار نوع‌دار

تعریف، Syntax و قرارداد متد

در ساده‌ترین حالت، Parse و TryParse از دید کارایی و حافظه یک رشته را دریافت می‌کند و مقدار int تحویل می‌دهد. محدوده یا قالب اصلی این نوع عبارت است از: وابسته به نوع مقصد و نرخ داده نامعتبر. موفقیت تبدیل فقط درست‌بودن قالب را ثابت می‌کند؛ قواعد دامنه مانند مثبت‌بودن مبلغ یا تعریف‌شدن مقدار Enum باید جداگانه کنترل شوند.

Syntax پایه و قابل اجرا

using System;
    
    public static class Program
    {
        public static void Main()
        {
            string text = "123456";
            Console.WriteLine("Use the benchmark examples below.");
        }
    }

پارامترها و نوع خروجی

• پارامتر اصلی، متن ورودی است و نباید بدون قرارداد مشخص از لایه نمایش به هسته دامنه عبور کند.
• برخی overloadها فرهنگ، NumberStyles، DateTimeStyles، قالب یا گزینه ignoreCase دریافت می‌کنند.
• نوع خروجی در این مقاله int است؛ در شکست، Parse معمولاً FormatException، ArgumentException یا OverflowException ایجاد می‌کند.
• مقدار null بسته به نوع و overload می‌تواند ArgumentNullException ایجاد کند؛ بنابراین سیاست null باید پیش از تبدیل روشن باشد.

Parse را باید به چشم یک مرز قرارداد دید. وقتی برنامه ادعا می‌کند متن حتماً معتبر است، شکست Parse وجود یک خطای داده یا برنامه‌نویسی را آشکار می‌کند. وقتی نامعتبر بودن قابل انتظار است، TryParse مدل مناسب‌تری برای کنترل جریان خواهد بود.

مثال‌های عملی مستقل

مثال‌ها از تبدیل پایه شروع می‌شوند و به داده دسته‌ای، null، مقدار مرزی، خطای کنترل‌شده و مسیر بهینه می‌رسند. هر نمونه یک برنامه کامل کنسولی است و خروجی نمایشی اجازه می‌دهد نتیجه را بدون اجرای فوری کد بررسی کنید.

مثال 1: اندازه‌گیری مسیر موفق Parse

در این آزمون یک مقدار معتبر بارها با Parse تبدیل می‌شود تا هزینه پایه تبدیل، بدون ورود به مسیر استثنا، دیده شود.

using System;
    using System.Diagnostics;
    
    public static class Program
    {
        public static void Main()
        {
            const string text = "123456";
            const int iterations = 200_000;
            var watch = System.Diagnostics.Stopwatch.StartNew();
            long sum = 0;
            for (int i = 0; i < iterations; i++)
            {
                sum += int.Parse(text);
            }
            watch.Stop();
            Console.WriteLine($"Sum={sum}; ElapsedMs={watch.ElapsedMilliseconds}");
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 2: اندازه‌گیری مسیر موفق TryParse

همان بار کاری با TryParse اجرا می‌شود. در ورودی‌های کاملاً معتبر اختلاف معمولاً کوچک است و نتیجه باید با اندازه‌گیری واقعی قضاوت شود.

using System;
    using System.Diagnostics;
    
    public static class Program
    {
        public static void Main()
        {
            const string text = "123456";
            const int iterations = 200_000;
            var watch = System.Diagnostics.Stopwatch.StartNew();
            long sum = 0;
            for (int i = 0; i < iterations; i++)
            {
                if (int.TryParse(text, out int value))
                {
                    sum += value;
                }
            }
            watch.Stop();
            Console.WriteLine($"Sum={sum}; ElapsedMs={watch.ElapsedMilliseconds}");
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 3: هزینه استثنا برای داده نامعتبر

این مثال عمداً داده نامعتبر را وارد Parse می‌کند. ساخت و پرتاب FormatException در حلقه داغ هزینه CPU و تخصیص حافظه را به‌طور محسوسی افزایش می‌دهد.

using System;
    
    public static class Program
    {
        public static void Main()
        {
            string[] values = { "10", "bad", "30", "?", "50" };
            int failures = 0;
            foreach (string text in values)
            {
                try
                {
                    _ = int.Parse(text);
                }
                catch (FormatException)
                {
                    failures++;
                }
            }
            Console.WriteLine($"Failures={failures}");
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 4: مسیر بدون استثنا برای داده نامعتبر

TryParse شکست قابل انتظار را با مقدار false گزارش می‌کند و از هزینه ایجاد استثنا در مسیر عادی برنامه جلوگیری می‌کند.

using System;
    
    public static class Program
    {
        public static void Main()
        {
            string[] values = { "10", "bad", "30", "?", "50" };
            int failures = 0;
            foreach (string text in values)
            {
                if (!int.TryParse(text, out _))
                {
                    failures++;
                }
            }
            Console.WriteLine($"Failures={failures}");
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 5: اندازه‌گیری تخصیص حافظه همان Thread

متد GetAllocatedBytesForCurrentThread دیدی عملی از تخصیص‌های مدیریت‌شده می‌دهد. گرم‌کردن کد و ثابت نگه‌داشتن ورودی برای کاهش خطای آزمون مهم است.

using System;
    
    public static class Program
    {
        public static void Main()
        {
            const string text = "42";
            _ = int.TryParse(text, out _);
            long before = GC.GetAllocatedBytesForCurrentThread();
            for (int i = 0; i < 100_000; i++)
            {
                _ = int.TryParse(text, out int value);
            }
            long allocated = GC.GetAllocatedBytesForCurrentThread() - before;
            Console.WriteLine($"AllocatedBytes={allocated}");
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 6: تبدیل مستقیم ReadOnlySpan

در پردازش بخشی از یک رشته می‌توان Span را مستقیماً تبدیل کرد تا ساخت Substring و تخصیص رشته موقت حذف شود.

using System;
    
    public static class Program
    {
        public static void Main()
        {
            ReadOnlySpan<char> line = "ID=84521;OK".AsSpan();
            ReadOnlySpan<char> idPart = line.Slice(3, 5);
            if (int.TryParse(idPart, out int id))
            {
                Console.WriteLine(id);
            }
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 7: اثر نرخ خطا بر انتخاب API

دو مجموعه با نرخ خطای متفاوت پردازش می‌شوند. این الگو نشان می‌دهد انتخاب Parse یا TryParse باید بر اساس قرارداد و احتمال شکست انجام شود.

using System;
    
    public static class Program
    {
        public static void Main()
        {
            string[] values = { "1", "2", "bad", "4", "bad", "6" };
            int valid = 0;
            int invalid = 0;
            foreach (string text in values)
            {
                if (int.TryParse(text, out _)) valid++;
                else invalid++;
            }
            Console.WriteLine($"Valid={valid}; Invalid={invalid}");
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 8: فرهنگ ثابت در پردازش سرویس

فرهنگ باید خارج از حلقه و به‌صورت صریح انتخاب شود تا تفسیر عدد پایدار بماند و ساخت اشیای تکراری وارد اندازه‌گیری نشود.

using System;
    using System.Globalization;
    
    public static class Program
    {
        public static void Main()
        {
            string[] values = { "10.5", "20.25", "30.75" };
            var culture = System.Globalization.CultureInfo.InvariantCulture;
            double total = 0;
            foreach (string text in values)
            {
                if (double.TryParse(text, System.Globalization.NumberStyles.Float, culture, out double value))
                {
                    total += value;
                }
            }
            Console.WriteLine(total.ToString(culture));
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 9: نمونه اشتباه و نسخه اصلاح‌شده

گرفتن همه Exceptionها در حلقه هم خطاهای برنامه‌نویسی را پنهان می‌کند و هم هزینه مسیر نامعتبر را بالا می‌برد. نسخه اصلاحی از TryParse استفاده می‌کند.

using System;
    
    public static class Program
    {
        public static void Main()
        {
            string text = "not-a-number";
            // روش اصلاح‌شده: شکست ورودی یک نتیجه عادی است.
            if (!int.TryParse(text, out int value))
            {
                Console.WriteLine("Invalid input");
            }
            else
            {
                Console.WriteLine(value);
            }
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

مثال 10: آزمون منصفانه با Warm-up و چند دور

یک بار اجرا برای نتیجه‌گیری کافی نیست. نمونه زیر کد را گرم می‌کند و چند دور مستقل می‌سنجد؛ برای تصمیم نهایی ابزار BenchmarkDotNet پیشنهاد می‌شود.

using System;
    using System.Diagnostics;
    
    public static class Program
    {
        public static void Main()
        {
            const string text = "9001";
            _ = int.TryParse(text, out _);
            for (int round = 1; round <= 3; round++)
            {
                var watch = System.Diagnostics.Stopwatch.StartNew();
                long sum = 0;
                for (int i = 0; i < 100_000; i++)
                {
                    if (int.TryParse(text, out int value)) sum += value;
                }
                watch.Stop();
                Console.WriteLine($"Round={round}; Sum={sum}; Ticks={watch.ElapsedTicks}");
            }
        }
    }

کاربرد عملی این الگو در مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای دیده می‌شود. در نسخه تولیدی، پیام خطا، ثبت رخداد، حریم خصوصی داده و تست واحد را متناسب با قرارداد سامانه تکمیل کنید.

تصویر 2: Parse و TryParse از دید کارایی و حافظه؛ مقایسه مسیر موفق، شکست و اعتبارسنجی

خطاهای رایج و روش اصلاح

بیشتر ایرادهای تبدیل از خود API ناشی نمی‌شوند؛ منشأ آن‌ها قرارداد مبهم ورودی است. مشخص نبودن Culture، اعتماد به متن کاربر، نادیده‌گرفتن محدوده نوع و استفاده از استثنا برای کنترل جریان، رفتار سامانه را غیرقابل پیش‌بینی می‌کند.

• فراخوانی Parse روی null یا رشته خالی؛ ابتدا سیاست مقدار اجباری، مقدار پیش‌فرض یا رد درخواست را تعیین کنید.
• تکیه بر Culture جاری سرور؛ برای داده بین‌سامانه‌ای از CultureInfo.InvariantCulture یا قالب دقیق استفاده کنید.
• فرض اینکه موفقیت تبدیل یعنی اعتبار کسب‌وکار؛ محدوده، موجودیت و قواعد دامنه را پس از تبدیل بسنجید.
• گرفتن catch کلی و ادامه خاموش برنامه؛ فقط خطای قابل بازیابی را بگیرید و اطلاعات تشخیصی مناسب ثبت کنید.
• تبدیل چندباره همان متن در لایه‌های مختلف؛ یک بار در مرز تبدیل کنید و مقدار نوع‌دار را به داخل بفرستید.
• قرار دادن Parse در حلقه‌ای با نرخ خطای بالا؛ در این مسیر از TryParse و پردازش نتیجه bool استفاده کنید.

کارایی، حافظه و رفتار سیستمی

برای ورودی معتبر، Parse و TryParse از دید کارایی و حافظه معمولاً عملیات کوتاهی است و مقدار مقصد را بدون نیاز به منطق پیچیده تولید می‌کند. با این حال هزینه واقعی به طول متن، فرهنگ، سبک عدد، نوع مقصد، نسخه Runtime، معماری CPU و نرخ شکست وابسته است.

تفاوت بزرگ زمانی دیده می‌شود که ورودی نامعتبر پرتکرار باشد. Parse برای گزارش شکست یک Exception می‌سازد و پرتاب می‌کند؛ این مسیر علاوه بر CPU می‌تواند تخصیص حافظه و فشار جمع‌آوری زباله ایجاد کند. TryParse شکست را با false برمی‌گرداند و برای داده کاربر یا فایل حجیم مناسب‌تر است.

در مسیرهای بسیار داغ، overloadهای مبتنی بر ReadOnlySpan می‌توانند از ساخت Substring جلوگیری کنند. این به معنی سریع‌تر بودن قطعی در هر پروژه نیست؛ آزمون باید در Release، بدون Debugger، پس از Warm-up و با داده‌ای شبیه تولید انجام شود. BenchmarkDotNet برای مقایسه علمی گزینه مطمئن‌تری است.

بهترین روش‌ها

• نوع مقصد را بر اساس دامنه انتخاب کنید، نه صرفاً بر اساس اینکه نمونه فعلی در آن جا می‌شود.
• قالب، Culture و سیاست null را بخشی از قرارداد API یا فایل بدانید.
• برای داده تضمین‌شده Parse و برای شکست قابل انتظار TryParse را انتخاب کنید.
• پیام خطای فارسی و قابل اقدام بسازید، اما داده محرمانه را در Log تکرار نکنید.
• پس از تبدیل، اعتبار دامنه‌ای مانند محدوده مجاز و وجود شناسه را جداگانه کنترل کنید.
• حالت‌های حداقل، حداکثر، صفر، منفی، فاصله، حروف و قالب ناسازگار را تست کنید.
• در حلقه داغ، تبدیل و ساخت CultureInfo یا Regex تکراری را حذف کنید.
• تصمیم کارایی را با پروفایل و Benchmark روی نسخه واقعی .NET تأیید کنید.

کاربرد واقعی در معماری نرم‌افزار

در سامانه سازمانی، Parse و TryParse از دید کارایی و حافظه بهتر است در لایه ورودی، Mapper یا Value Object قرار گیرد. رشته خام مربوط به مسیرهای پرترافیک، ورودی کاربر، فایل‌های حجیم، APIها و پردازش دسته‌ای پس از اعتبارسنجی به مقدار نوع‌دار تبدیل می‌شود و لایه دامنه دیگر درگیر جزئیات نمایش متن نیست.

این الگو تست‌پذیری را افزایش می‌دهد، پیام‌های خطا را یکپارچه می‌کند و مانع پخش‌شدن منطق تبدیل در Controller، فرم و Repository می‌شود. برای پروژه‌های بزرگ می‌توان نتیجه تبدیل را در یک Result type قرار داد تا خطا بدون Exception به لایه نمایش برگردد.

سؤالات متداول

۱. Parse و TryParse از دید کارایی و حافظه دقیقاً چه کاری انجام می‌دهد؟

Parse و TryParse از دید کارایی و حافظه نمایش متنی معتبر را مطابق قواعد نوع مقصد به یک مقدار نوع‌دار تبدیل می‌کند. نتیجه پس از تبدیل می‌تواند در محاسبه، شرط، ذخیره‌سازی یا منطق دامنه استفاده شود و دیگر لازم نیست با رشته خام کار کنیم.

۲. چه زمانی استفاده از Parse و TryParse از دید کارایی و حافظه برای تازه‌کاران مناسب است؟

وقتی منبع داده مورد اعتماد است، قالب از قبل اعتبارسنجی شده و شکست واقعاً یک وضعیت استثنایی محسوب می‌شود، Parse انتخابی ساده و خواناست. برای ورودی مستقیم کاربر معمولاً TryParse تجربه مقاوم‌تری ایجاد می‌کند.

۳. آیا استفاده درست از Parse و TryParse از دید کارایی و حافظه هزینه نگهداری پروژه را کم می‌کند؟

بله؛ تبدیل در مرز سیستم و انتقال مقدار نوع‌دار به لایه‌های داخلی، شرط‌های تکراری و خطاهای پنهان را کاهش می‌دهد. این جداسازی در پروژه‌های تجاری، گزارش‌گیری و سامانه‌های چندلایه ارزش زیادی دارد.

۴. در پروژه سفارشی چگونه سیاست تبدیل Parse و TryParse از دید کارایی و حافظه طراحی می‌شود؟

قالب ورودی، فرهنگ، رفتار null، محدوده مجاز، پیام خطا و محل ثبت رخداد باید در قرارداد ورودی مشخص شوند. سپس تبدیل در یک نقطه مشترک مانند Validator، Mapper یا لایه ورودی پیاده‌سازی و با تست پوشش داده می‌شود.

۵. تفاوت کلیدی Parse و TryParse برای Parse و TryParse از دید کارایی و حافظه چیست؟

Parse در شکست استثنا پرتاب می‌کند، ولی TryParse با یک مقدار bool موفقیت را گزارش می‌دهد و خروجی را از پارامتر out تحویل می‌دهد. تفاوت اصلی در قرارداد شکست است، نه صرفاً شکل نوشتن کد.

۶. برای پیاده‌سازی حرفه‌ای Parse و TryParse از دید کارایی و حافظه چه خدماتی لازم می‌شود؟

در سامانه حساس می‌توان از بازبینی قرارداد داده، طراحی اعتبارسنجی، تست داده‌های مرزی، پروفایل کارایی و ثبت خطای ساخت‌یافته استفاده کرد. مشاوره فنی کمک می‌کند این تصمیم‌ها با معماری و نیاز واقعی محصول هماهنگ شوند.

۷. خطاهای رایج Parse و TryParse از دید کارایی و حافظه کدام‌اند؟

ارسال null، رشته خالی، قالب ناسازگار، عدد خارج از محدوده، فرهنگ اشتباه و گرفتن کلی همه Exceptionها از خطاهای پرتکرار هستند. ثبت مقدار حساس نیز باید با قواعد امنیت و حریم خصوصی هماهنگ شود.

۸. آیا Parse و TryParse از دید کارایی و حافظه از نظر Performance کند است؟

روی ورودی معتبر معمولاً تبدیل سریع است؛ مشکل اصلی زمانی رخ می‌دهد که داده نامعتبر زیاد باشد و Parse مرتب استثنا بسازد. اندازه‌گیری با داده واقعی، Release build، Runtime هدف و ابزار مناسب از حدس بهتر است.

۹. بهترین روش استفاده از Parse و TryParse از دید کارایی و حافظه چیست؟

فرهنگ و قالب را صریح کنید، تبدیل را در مرز ورودی نگه دارید، دامنه مجاز را جداگانه بسنجید، از تبدیل تکراری جلوگیری کنید و برای تمام کران‌ها تست داشته باشید. شکست قابل انتظار را نیز با TryParse مدل کنید.

۱۰. Parse و TryParse از دید کارایی و حافظه با کدام نسخه‌های C# و .NET سازگار است؟

شکل‌های پایه Parse سال‌هاست در .NET وجود دارند، اما overloadهای Generic، Span و رابط‌های جدید مانند IParsable به نسخه Runtime وابسته‌اند. پیش از استفاده از overload جدید، Target Framework پروژه و مستندات همان نسخه را کنترل کنید.

سؤالات مصاحبه

چک‌لیست نهایی

• نوع مقصد و محدوده آن با دامنه هماهنگ است.
• قالب و Culture ورودی مستند شده است.
• رفتار null و رشته خالی مشخص است.
• Parse یا TryParse بر اساس قرارداد شکست انتخاب شده است.
• اعتبار نحوی و اعتبار کسب‌وکار جدا هستند.
• مقادیر مرزی و نامعتبر تست شده‌اند.
• در مسیر پرترافیک اندازه‌گیری واقعی انجام شده است.
• پیام خطا مفید است و اطلاعات حساس را افشا نمی‌کند.

جمع‌بندی

Parse و TryParse از دید کارایی و حافظه زمانی بهترین انتخاب است که متن مطابق قراردادی قطعی و معتبر وارد شود و شکست باید یک وضعیت استثنایی باشد. برای ورودی نامطمئن، TryParse کنترل صریح‌تر و معمولاً رفتار کاراتری در مسیر شکست ارائه می‌کند. انتخاب نوع، فرهنگ، تست مرزی و محل تبدیل به اندازه خود فراخوانی متد اهمیت دارند.

برای مقایسه این API با سایر تبدیل‌ها، راهنمای جامع متدهای Parse در C# و .NET را ببینید. این راهنما نقشه کامل bool، انواع عددی، DateTime، Guid، Enum و تحلیل کارایی را یکجا ارائه می‌کند.